Set-AzureVMAccessExtension

Referência

Módulo:: Azure

Define a extensão VMAccess para uma máquina virtual.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

Set-AzureVMAccessExtension
   [[-UserName] <String>]
   [[-Password] <String>]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Set-AzureVMAccessExtension
   [-Disable]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Set-AzureVMAccessExtension
   [-Uninstall]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureVMAccessExtension adiciona a Extensão VMAccess da Máquina Virtual 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.

Exemplos

Exemplo 1: Definir a extensão VMAccess aplicada a uma máquina virtual especificada

PS C:\> Set-AzureVMAccessExtension -VM $VM -UserName $User -Password $PWD;

Este comando define a extensão VMAccess aplicada à máquina virtual especificada como armazenada na variável $VM.

Parâmetros

-Disable

Indica que esse cmdlet define o Estado da Extensão como Desabilitar.

Type:	SwitchParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ForceUpdate

Indica que esse cmdlet reaplica uma configuração a uma extensão quando a configuração não foi atualizada.

Type:	SwitchParameter
Position:	5
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

Continuar
Ignorar
Perguntar
SilentlyContinue
Stop
Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Especifica uma variável de informação.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Password

Especifica a senha para redefinir a credencial da máquina virtual.

Type:	String
Position:	2
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ReferenceName

Especifica o nome de referência da extensão de acesso.

Esta é uma cadeia de caracteres definida pelo usuário que é usada para se referir a uma extensão. Ele é especificado quando a extensão é adicionada à máquina virtual pela primeira vez. Para atualizações subsequentes, você deve especificar o nome de referência usado anteriormente ao atualizar a extensão. O ReferenceName atribuído a uma extensão é retornado usando o cmdlet Get-AzureVM .

Type:	String
Position:	3
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Uninstall

Indica se esse cmdlet desinstala a extensão de acesso.

Type:	SwitchParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-UserName

Especifica o nome de usuário que esse cmdlet usa para redefinir a credencial da máquina virtual.

Type:	String
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Version

Especifica a versão da extensão.

Type:	String
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VM

Especifica o objeto de máquina virtual persistente.

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False