Set-AzureVMCustomScriptExtension

Referência

Módulo:: Azure

Define informações para uma extensão de script personalizada de máquina virtual do Azure.

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-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [-ContainerName] <String>
   [-FileName] <String[]>
   [[-StorageAccountName] <String>]
   [[-StorageEndpointSuffix] <String>]
   [[-StorageAccountKey] <String>]
   [[-Run] <String>]
   [[-Argument] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

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

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

Set-AzureVMCustomScriptExtension
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   [[-FileUri] <String[]>]
   [-Run] <String>
   [[-Argument] <String>]
   [-ForceUpdate]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureVMCustomScriptExtension define informações para uma extensão de script personalizada da máquina virtual do Azure.

Exemplos

Exemplo 1: Definir informações para uma extensão de script personalizado de máquina virtual

PS C:\> $VM = Set-AzureVMCustomScriptExtension -VM $VM -ContainerName "Container01" -FileName "script1.ps1","script2.ps1" -Run "script1.ps1" -Argument "arg1 arg2";
PS C:\> New-AzureVM -Location "West US" -ServiceName $SVC -VM $VM;

Este comando define informações para uma extensão de script personalizado de máquina virtual.

Exemplo 2: Definir informações para uma extensão de script personalizada de máquina virtual usando um caminho de arquivo

PS C:\> Set-AzureVMCustomScriptExtension -VM $VM -FileUri "http://www.blob.core.contoso.net/bar/script1.ps1","http://www.blob.core.contoso.net/baz/script2.ps1" -Run "script1.ps1" -Argument "arg1 arg2";
PS C:\> Update-AzureVM -ServiceName $SVC -Name $Name -VM VM;

Este comando define informações para uma extensão de script personalizada de máquina virtual usando várias URLs de arquivo.

Parâmetros

-Argument

Especifica uma cadeia de caracteres que fornece um argumento que esse cmdlet executa na máquina virtual.

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

-ContainerName

Especifica o nome do contêiner dentro da conta de armazenamento.

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

-Disable

Indica que esse cmdlet desabilita o estado da extensão.

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

-FileName

Especifica uma matriz de cadeia de caracteres que contém os nomes dos arquivos de blob no contêiner especificado.

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

-FileUri

Especifica uma matriz de cadeia de caracteres que contém as URLs dos arquivos de blob.

Type:	String[]
Position:	2
Default value:	None
Required:	False
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:	9
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

-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 para a extensão.

Esse parâmetro é uma cadeia de caracteres definida pelo usuário que pode ser usada para fazer referência a uma extensão. Ele é especificado 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:	0
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Run

Especifica o comando que esse cmdlet executa pela extensão na máquina virtual. Apenas "powershell.exe" é suportado.

Type:	String
Aliases:	RunFile, Command
Position:	7
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-StorageAccountKey

Especifica a chave da conta de armazenamento

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

-StorageAccountName

Especifica o nome da conta de armazenamento na assinatura atual.

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

-StorageEndpointSuffix

Especifica o ponto de extremidade do serviço de armazenamento.

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

-Uninstall

Indica que esse cmdlet desinstala a extensão de script personalizada da máquina virtual.

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

-Version

Especifica a versão da extensão de script personalizada.

Type:	String
Position:	1
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