Freigeben über

New-AzureAutomationVariable

  • Referenz
Modul:
Azure

Erstellt eine Automatisierungsvariable.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

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

Beschreibung

Wichtig

Dieser PowerShell-Befehl für Azure Automation wird ab dem 23.01.2020 länger unterstützt. Das Azure Service Management-Modell ist für Azure Automation veraltet und wurde am betreffenden Datum deaktiviert. Verwenden Sie die Befehle, die das Azure Resource Management-Modell in Az.Automation unterstützen.

Das Cmdlet New-AzureAutomationVariable erstellt eine Variable in Microsoft Azure Automation.

Beispiele

Beispiel 1: Erstellen einer neuen Variablen mit einem einfachen Wert

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

Dieser Befehl erstellt eine neue Variable namens MyStringVariable mit einem Zeichenfolgenwert im Azure Automation-Konto namens Contoso17.

Beispiel 2: Erstellen einer neuen Variablen mit einem komplexen Wert

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

Diese Befehle erstellen eine neue Variable namens "MyComplexVariable" im Automatisierungskonto namens Contoso17. Ein komplexes Objekt wird für seinen Wert verwendet, in diesem Fall ein virtuelles Computerobjekt.

Parameter

-AutomationAccountName

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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 der Wert der Variablen verschlüsselt gespeichert werden soll.

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:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Value

Gibt einen Wert an, der in der Variablen gespeichert werden soll.

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

Ausgaben

Variable