Partilhar via

New-AzureAutomationVariable

  • Referência
Módulo:
Azure

Cria uma variável Automation.

Nota

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

O módulo Az PowerShell é o módulo PowerShell recomendado 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

Este 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 de Gerenciamento de Recursos do Azure 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"

Este 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
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Description

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

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

-Encrypted

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

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

-Name

Especifica um nome para a variável.

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

-Profile

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

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

-Value

Especifica um valor a ser armazenado na variável.

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

Saídas

Variable