Compartilhar via


Set-AzVMProxyAgentSetting

Define as propriedades de configurações do Agente Proxy para um objeto PSVirtualMachine.

Sintaxe

Default (Default)

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

Description

Define as propriedades de configurações do Agente Proxy para um objeto PSVirtualMachine.

Exemplos

Exemplo 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}"

Este comando define as configurações do Agente proxy para um objeto $vmconfigde configuração de máquina virtual. Ele habilita o Agente proxy, define o modo wire server como "Impor", especifica o perfil do IMDS.

Parâmetros

-AddProxyAgentExtension

Especifica se a extensão ProxyAgent deve ser instalada implicitamente. No momento, essa opção é aplicável somente para o sistema operacional Linux.

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-EnableProxyAgent

Especifica se o recurso ProxyAgent (Protocolo de Segurança de Metadados) deve ser habilitado ou não.

Propriedades do parâmetro

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ImdsMode

Especifica o modo de execução do ponto de extremidade IMDS. No modo auditoria, o sistema atua como se estivesse impondo a política de controle de acesso, incluindo a emissão de entradas de negação de acesso nos logs, mas não nega nenhuma solicitação para hospedar pontos de extremidade. No modo Impor, o sistema imporá o controle de acesso e ele é o modo de operação recomendado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ImdsProfile

Especifica a ID do recurso InVMAccessControlProfileVersion no ponto de enpoint do IMDS. Formato de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-KeyIncarnationId

Aumentar o valor desse parâmetro permite que os usuários redefinam a chave usada para proteger o canal de comunicação entre o convidado e o host.

Propriedades do parâmetro

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-VM

Objeto PSVirtualMachine criado a partir de New-AzVMConfig.

Propriedades do parâmetro

Tipo:PSVirtualMachine
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Máquina virtual

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WireServerMode

Especifica o modo de execução do ponto de extremidade do Wire Server ao criar a máquina virtual ou o conjunto de dimensionamento de máquinas virtuais. No modo auditoria, o sistema atua como se estivesse impondo a política de controle de acesso, incluindo a emissão de entradas de negação de acesso nos logs, mas não nega nenhuma solicitação para hospedar pontos de extremidade. No modo Impor, o sistema imporá o controle de acesso e ele é o modo de operação recomendado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-WireServerProfile

Especifica a ID do recurso InVMAccessControlProfileVersion no ponto de extremidade do Wire Server. Formato de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSVirtualMachine

SwitchParameter

String

Int32

Saídas

PSVirtualMachine