Freigeben über

New-AzAutomationVariable

  • Referenz
Modul:
Az.Automation

Erstellt eine Automatisierungsvariable.

Syntax

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

Beschreibung

Das Cmdlet New-AzAutomationVariable erstellt eine Variable in Azure Automation. Um die Variable zu verschlüsseln, geben Sie den Parameter Encrypted an. Sie können den verschlüsselten Zustand einer Variablen nach der Erstellung nicht ändern.

Beispiele

Beispiel 1: Erstellen einer Variablen mit einem einfachen Wert

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

Dieser Befehl erstellt eine Variable namens StringVariable22 mit einem Zeichenfolgenwert im Automatisierungskonto namens Contoso17.

Beispiel 2: Erstellen einer Variablen mit einem komplexen Wert

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

Der erste Befehl ruft einen virtuellen Computer mithilfe des Cmdlets Get-AzVM ab. Der Befehl speichert sie in der variablen $VirtualMachine. Der zweite Befehl erstellt eine Variable namens "ComplexVariable01" im Automatisierungskonto "Contoso17". Dieser Befehl verwendet ein komplexes Objekt für seinen Wert, in diesem Fall der virtuelle Computer in $VirtualMachine.

Parameter

-AutomationAccountName

Gibt den Namen des Automatisierungskontos an, in dem die Variable gespeichert werden soll.

Typ:String
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für die Variable an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Encrypted

Gibt an, ob dieses Cmdlet den Wert der Variablen für den Speicher verschlüsselt.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt einen Namen für die Variable an.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Gibt die Ressourcengruppe an, für die dieses Cmdlet eine Variable erstellt.

Typ:String
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Value

Gibt einen Wert für die Variable an.

Typ:Object
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

String

Boolean

Object

Ausgaben

Variable