Compartilhar via

New-AzureAutomationVariable

  • Referência
Módulo:
Azure

Cria uma variável de automação.

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

New-AzureAutomationVariable
   -Name <String>
   -Encrypted <Boolean>
   [-Description <String>]
   [-Value <Object>]
   -AutomationAccountName <String>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Importante

Esse comando do PowerShell para Automação do Azure tem mais suporte a partir de 23/01/2020. O modelo de Gerenciamento de Serviços do Azure foi preterido para a Automação do Azure e foi desabilitado nessa data. Use os comandos que dão suporte ao modelo do Azure Resource Management no Az.Automation.

O cmdlet New-AzureAutomationVariable cria uma variável na Automação do Microsoft Azure.

Exemplos

Exemplo 1: Criar uma nova variável com um valor simples

PS C:\> New-AzureAutomationVariable -AutomationAccountName "Contoso17" -Name "MyStringVariable" -Encrypted $False -Value "My String"

Esse comando cria uma nova variável chamada MyStringVariable com um valor de cadeia de caracteres na conta de Automação do Azure chamada Contoso17.

Exemplo 2: Criar uma nova variável com um valor complexo

PS C:\> $vm = Get-AzureVM -ServiceName "MyVM" -Name "MyVM"
PS C:\> New-AzureAutomationVariable -AutomationAccountName "Contoso17" -Name "MyComplexVariable" -Encrypted $False -Value $vm

Esses comandos criam uma nova variável chamada MyComplexVariable na conta de Automação chamada Contoso17. Um objeto complexo é usado por seu valor, neste caso, um objeto de máquina virtual.

Parâmetros

-AutomationAccountName

Especifica o nome da conta de Automação na qual a variável será armazenada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Description

Especifica uma descrição para a variável.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Encrypted

Indica se o valor da variável deve ser armazenado criptografado.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica um nome para a variável.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Value

Especifica um valor a ser armazenado na variável.

Tipo:Object
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

Variable