Partilhar via


Set-AzVMProxyAgentSetting

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

Sintaxe

Default (Padrão)

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

Descrição

Define as propriedades de configurações do Proxy Agent 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 Proxy Agent para um objeto $vmconfigde configuração de máquina virtual. Ele habilita o Proxy Agent, define o modo Wire Server como "Enforce", especifica o perfil IMDS.

Parâmetros

-AddProxyAgentExtension

Especifica se a extensão ProxyAgent deve ser instalada implicitamente. Atualmente, esta opção é aplicável apenas para Linux OS.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:False
Valor dos argumentos restantes:False

-EnableProxyAgent

Especifica se o recurso Metadata Security Protocol (ProxyAgent) deve ser habilitado ou não.

Propriedades dos parâmetros

Tipo:

Nullable<T>[Boolean]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ImdsMode

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

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-ImdsProfile

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

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-KeyIncarnationId

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

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-VM

Objeto PSVirtualMachine criado a partir de New-AzVMConfig.

Propriedades dos parâmetros

Tipo:PSVirtualMachine
Valor padrão:None
Suporta curingas:False
DontShow:False
Pseudónimos:Máquina virtual

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome da propriedade:True
Valor dos argumentos restantes:False

-WireServerMode

Especifica o modo de execução do ponto de extremidade do Wire Server durante a criação da máquina virtual ou do conjunto de dimensionamento da máquina virtual. No modo de auditoria, o sistema age como se estivesse aplicando a política de controle de acesso, incluindo a emissão de entradas de negação de acesso nos logs, mas na verdade não nega nenhuma solicitação para hospedar pontos de extremidade. No modo Enforce, o sistema irá impor o controle de acesso e é o modo recomendado de operação.

Propriedades dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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 dos parâmetros

Tipo:String
Valor padrão:None
Suporta curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Posição:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por 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