你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Set-AzVMProxyAgentSetting

设置 PSVirtualMachine 对象的代理代理设置属性。

语法

Default (默认值)

Set-AzVMProxyAgentSetting
    -VM <PSVirtualMachine>
    [-EnableProxyAgent <Boolean>]
    [-WireServerMode <String>]
    [-WireServerProfile <String>]
    [-ImdsMode <String>]
    [-ImdsProfile <String>]
    [-KeyIncarnationId <Int32>]
    [-AddProxyAgentExtension <Boolean>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

设置 PSVirtualMachine 对象的代理代理设置属性。

示例

示例 1

$vmconfig = New-AzVMConfig -VMName $vmName -VMSize "Standard_D2s_v3"
Set-AzVMProxyAgentSetting -VM $vmconfig -EnableProxyAgent $true -AddProxyAgentExtension false -WireServerMode "Enforce" -ImdsProfile "/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}"

此命令设置虚拟机配置对象的 $vmconfig代理代理设置。 它使代理能够将 Wire Server 模式设置为“强制”,并指定 IMDS 配置文件。

参数

-AddProxyAgentExtension

指定是否隐式安装 ProxyAgent 扩展。 此选项目前仅适用于 Linux OS。

参数属性

类型:

Nullable<T>[Boolean]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EnableProxyAgent

指定是否应启用元数据安全协议(ProxyAgent)功能。

参数属性

类型:

Nullable<T>[Boolean]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ImdsMode

指定 IMDS 终结点执行模式。 在审核模式下,系统就像强制实施访问控制策略一样,包括在日志中发出访问拒绝条目,但它实际上不会拒绝对主机终结点的任何请求。 在“强制”模式下,系统将强制实施访问控制,这是建议的作模式。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ImdsProfile

指定 IMDS enpoint 中的 InVMAccessControlProfileVersion 资源 ID。 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-KeyIncarnationId

增加此参数的值允许用户重置用于保护来宾和主机之间的信道的密钥。

参数属性

类型:

Nullable<T>[Int32]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-VM

从 New-AzVMConfig 创建的 PSVirtualMachine 对象。

参数属性

类型:PSVirtualMachine
默认值:None
支持通配符:False
不显示:False
别名:虚拟机

参数集

(All)
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WireServerMode

在创建虚拟机或虚拟机规模集时指定 Wire Server 终结点执行模式。 在审核模式下,系统就像强制实施访问控制策略一样,包括在日志中发出访问拒绝条目,但它实际上不会拒绝对主机终结点的任何请求。 在“强制”模式下,系统将强制实施访问控制,这是建议的作模式。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-WireServerProfile

指定 Wire Server 终结点中的 InVMAccessControlProfileVersion 资源 ID。 /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

PSVirtualMachine

SwitchParameter

String

Int32

输出

PSVirtualMachine