New-AzAutomationVariable
Erstellt eine Automatisierungsvariable.
Syntax
Default (Standard)
New-AzAutomationVariable
[-Name] <String>
-Encrypted <Boolean>
[-Description <String>]
[-Value <Object>]
[-ResourceGroupName] <String>
[-AutomationAccountName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Beschreibung
Das Cmdlet New-AzAutomationVariable erstellt in Azure Automation eine Variable.
Um die Variable zu verschlüsseln, geben Sie den Encrypted-Parameter 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.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: 1
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-DefaultProfile
Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure
Parametereigenschaften
Typ: IAzureContextContainer
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Aliase: AzContext, AzureRmContext, AzureCredential
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: False
Wert aus verbleibenden Argumenten: False
-Description
Gibt eine Beschreibung für die Variable an.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Encrypted
Gibt an, ob dieses Cmdlet den Wert der Variablen für den Speicher verschlüsselt.
Parametereigenschaften
Typ: Boolean
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Name
Gibt einen Namen für die Variable an.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: 2
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-ResourceGroupName
Gibt die Ressourcengruppe an, für die dieses Cmdlet eine Variable erstellt.
Parametereigenschaften
Typ: String
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: 0
Obligatorisch: True
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
-Value
Gibt einen Wert für die Variable an.
Parametereigenschaften
Typ: Object
Standardwert: None
Unterstützt Platzhalter: False
Nicht anzeigen: False
Parametersätze
(All)
Position: Named
Obligatorisch: False
Wert aus Pipeline: False
Wert aus Pipeline nach dem Eigenschaftsnamen: True
Wert aus verbleibenden Argumenten: False
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Ausgaben