Set-AzureVMExtension
Define extensões de recurso para máquinas virtuais.
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-AzureVMExtension
[-ExtensionName] <String>
[-Publisher] <String>
[-Version] <String>
[[-ReferenceName] <String>]
[[-PublicConfiguration] <String>]
[[-PrivateConfiguration] <String>]
[-Disable]
[-Uninstall]
[[-PublicConfigKey] <String>]
[[-PrivateConfigKey] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureVMExtension
[-ExtensionName] <String>
[-Publisher] <String>
[-Version] <String>
[[-ReferenceName] <String>]
[[-PublicConfigPath] <String>]
[[-PrivateConfigPath] <String>]
[-Disable]
[-Uninstall]
[[-PublicConfigKey] <String>]
[[-PrivateConfigKey] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureVMExtension
[-ReferenceName] <String>
[[-PublicConfiguration] <String>]
[[-PrivateConfiguration] <String>]
[-Disable]
[-Uninstall]
[[-PublicConfigKey] <String>]
[[-PrivateConfigKey] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Set-AzureVMExtension
[-ReferenceName] <String>
[[-PublicConfigPath] <String>]
[[-PrivateConfigPath] <String>]
[-Disable]
[-Uninstall]
[[-PublicConfigKey] <String>]
[[-PrivateConfigKey] <String>]
[-ForceUpdate]
-VM <IPersistentVM>
[-Profile <AzureSMProfile>]
[-InformationAction <ActionPreference>]
[-InformationVariable <String>]
[<CommonParameters>]
Description
O cmdlet Set-AzureVMExtension define extensões de recurso para máquinas virtuais.
Exemplos
Exemplo 1: Criar uma máquina virtual com extensões de recurso aplicadas
PS C:\> $X = New-AzureVMConfig -Name $VM -InstanceSize Small -ImageName $IMG;$X = Add-AzureProvisioningConfig -VM $X -Password $PWD -AdminUsername $USR -Windows;$X = Set-AzureVMExtension -VM $X -ExtensionName $Ext1 -Publisher $Publisher -Version $VER -PublicConfiguration $P1 -PrivateConfiguration $P2;$X = Set-AzureVMExtension -VM $X -ExtensionName $Ext2 -Publisher $Publisher -Version $VER -PublicConfiguration $P3 -PrivateConfiguration $P4;New-AzureVM -Location $LOC -ServiceName $SVC -VM $X;
Esse comando cria uma máquina virtual com extensões de recurso aplicadas.
Parâmetros
-Disable
Indica que esse cmdlet desabilita o estado da extensão.
Type: | SwitchParameter |
Position: | 7 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ExtensionName
Especifica o nome da extensão da máquina virtual.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ForceUpdate
Indica que esse cmdlet aplica novamente uma configuração a uma extensão quando a configuração não foi atualizada.
Type: | SwitchParameter |
Position: | 11 |
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 |
-PrivateConfigKey
Especifica uma chave de configuração privada.
Type: | String |
Position: | 10 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PrivateConfigPath
Especifica o caminho de configuração privada.
Type: | String |
Position: | 6 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PrivateConfiguration
Especifica o texto de configuração privada.
Type: | String |
Position: | 6 |
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 |
-PublicConfigKey
Especifica a chave de configuração pública.
Type: | String |
Position: | 9 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicConfigPath
Especifica o caminho de configuração pública.
Type: | String |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PublicConfiguration
Especifica o texto de configuração pública.
Type: | String |
Position: | 5 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Publisher
Especifica o editor da extensão.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ReferenceName
Especifica o nome de referência da extensão.
Esta é uma cadeia de caracteres definida pelo usuário que pode ser usada para fazer referência a uma extensão. Você precisa especificá-lo quando a extensão é adicionada à máquina virtual pela primeira vez. Para atualizações subsequentes, você precisa 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: | 4 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Uninstall
Indica que esse cmdlet desinstala a extensão de recurso da máquina virtual.
Type: | SwitchParameter |
Position: | 8 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Especifica a versão da extensão.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
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 |