Partilhar via

Set-AzVMAccessExtension

  • Referência
Módulo:
Az.Compute

Adiciona a extensão VMAccess a uma máquina virtual.

Sintaxe

Set-AzVMAccessExtension
   [-Credential <PSCredential>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   -Name <String>
   [-TypeHandlerVersion <String>]
   [-Location <String>]
   [-DisableAutoUpgradeMinorVersion]
   [-ForceRerun <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzVMAccessExtension adiciona a Extensão VMAccess da Máquina Virtual (Virtual Machine Access) VMAccess a uma máquina virtual. VMAccess Extension pode ser usado para definir uma senha temporária e isso deve ser imediatamente alterado após o login na máquina. Isso não é suportado em controladores de domínio do Windows.

Exemplos

Exemplo 1: Adicionar uma extensão VMAccess

Set-AzVMAccessExtension -ResourceGroupName "ResourceGroup11" -Location "Central US" -VMName "VirtualMachine07" -Name "ContosoTest" -TypeHandlerVersion "2.4"

Este comando adiciona uma extensão VMAccess para a máquina virtual chamada VirtualMachine07 em ResourceGroup11. O comando especifica o nome e a versão do manipulador de tipo para VMAccess.

Exemplo 2

Adiciona a extensão VMAccess a uma máquina virtual. (gerado automaticamente)

Set-AzVMAccessExtension -Credential <PSCredential> -Location 'Central US' -Name 'ContosoTest' -ResourceGroupName 'ResourceGroup11' -TypeHandlerVersion '2.4' -VMName 'VirtualMachine07'

Parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica o nome de usuário e a senha para a máquina virtual como um objeto PSCredential . Se você digitar um nome diferente da conta de administrador local atual em sua VM, a extensão VMAccess adicionará uma conta de administrador local com esse nome e atribuirá sua senha especificada a essa conta. Se a conta de administrador local na sua VM existir, ela redefinirá a senha e, se a conta estiver desabilitada, a extensão VMAccess a habilitará. Para obter uma credencial, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

Tipo:PSCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisableAutoUpgradeMinorVersion

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ForceRerun

Indica que esse cmdlet força uma nova execução da mesma configuração de extensão na máquina virtual sem desinstalar e reinstalar a extensão. O valor pode ser qualquer cadeia de caracteres diferente do valor atual. Se forceUpdateTag não for alterado, as atualizações para configurações públicas ou protegidas ainda serão aplicadas pelo manipulador.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Location

Especifica o local da máquina virtual.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

Especifica o nome da extensão adicionada por esse cmdlet.

Tipo:String
Aliases:ExtensionName
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-NoWait

Inicia a operação e retorna imediatamente, antes que a operação seja concluída. Para determinar se a operação foi concluída com êxito, use algum outro mecanismo.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceGroupName

Especifica o nome do grupo de recursos da máquina virtual.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-TypeHandlerVersion

Especifica a versão da extensão a ser usada para essa máquina virtual. Para obter a versão, execute o cmdlet Get-AzVMExtensionImage com um valor de Microsoft.Compute para o parâmetro PublisherName e VMAccessAgent para o parâmetro Type. O typeHandlerVersion deve ser 2.0 ou superior, pois a versão 1 foi preterida.

Tipo:String
Aliases:HandlerVersion, Version
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-VMName

Especifica o nome de uma máquina virtual. Este cmdlet adiciona VMAccess para a máquina virtual especificada por esse parâmetro.

Tipo:String
Aliases:ResourceName
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSCredential

String

SwitchParameter

Saídas

PSAzureOperationResponse