Partilhar via


New-AzAutomationVariable

Cria uma variável Automation.

Sintaxe

New-AzAutomationVariable
   [-Name] <String>
   -Encrypted <Boolean>
   [-Description <String>]
   [-Value <Object>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet New-AzAutomationVariable cria uma variável na Automação do Azure. Para criptografar a variável, especifique o parâmetro Encrypted . Não é possível modificar o estado criptografado de uma variável após a criação.

Exemplos

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

New-AzAutomationVariable -AutomationAccountName "Contoso17" -Name "StringVariable22" -Encrypted $False -Value "My String" -ResourceGroupName "ResourceGroup01"

Este comando cria uma variável chamada StringVariable22 com um valor de cadeia de caracteres na conta de automação chamada Contoso17.

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

$VirtualMachine = Get-AzVM -Name "VirtualMachine03"
New-AzAutomationVariable -AutomationAccountName "Contoso17" -Name "ComplexVariable01" -Encrypted $False -Value $VirtualMachine -ResourceGroupName "ResourceGroup01"

O primeiro comando obtém uma máquina virtual usando o cmdlet Get-AzVM. O comando armazena-o na variável $VirtualMachine. O segundo comando cria uma variável chamada ComplexVariable01 na conta de automação chamada Contoso17. Este comando usa um objeto complexo para seu valor, neste caso, a máquina virtual em $VirtualMachine.

Parâmetros

-AutomationAccountName

Especifica o nome da conta de automação na qual armazenar a variável.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
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

Especifica se esse cmdlet criptografa o valor da variável para armazenamento.

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

-ResourceGroupName

Especifica o grupo de recursos para o qual esse cmdlet cria uma variável.

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

-Value

Especifica um valor para a variável.

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

Entradas

String

Boolean

Object

Saídas

Variable