Delen via


New-AzAutomationVariable

Hiermee maakt u een Automation-variabele.

Syntax

Default (Standaard)

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

Description

Met de cmdlet New-AzAutomationVariable wordt een variabele gemaakt in Azure Automation. Als u de variabele wilt versleutelen, geeft u de parameter Encrypted op. U kunt de versleutelde status van een variabele niet wijzigen nadat deze is gemaakt.

Voorbeelden

Voorbeeld 1: Een variabele maken met een eenvoudige waarde

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

Met deze opdracht maakt u een variabele met de naam StringVariable22 met een tekenreekswaarde in het Automation-account met de naam Contoso17.

Voorbeeld 2: Een variabele maken met een complexe waarde

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

Met de eerste opdracht wordt een virtuele machine ophaalt met behulp van de cmdlet Get-AzVM. Met de opdracht wordt deze opgeslagen in de variabele $VirtualMachine. Met de tweede opdracht maakt u een variabele met de naam ComplexVariable01 in het Automation-account met de naam Contoso17. Met deze opdracht wordt een complex object gebruikt voor de waarde, in dit geval de virtuele machine in $VirtualMachine.

Parameters

-AutomationAccountName

Hiermee geeft u de naam op van het Automation-account waarin de variabele moet worden opgeslagen.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement dat wordt gebruikt voor communicatie met Azure

Parametereigenschappen

Type:IAzureContextContainer
Default value:None
Ondersteunt jokertekens:False
DontShow:False
Aliassen:AzContext, AzureRmContext, AzureCredential

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Description

Hiermee geeft u een beschrijving voor de variabele.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Encrypted

Hiermee geeft u op of deze cmdlet de waarde van de variabele voor opslag versleutelt.

Parametereigenschappen

Type:Boolean
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Hiermee geeft u een naam voor de variabele.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:2
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-ResourceGroupName

Hiermee geeft u de resourcegroep waarvoor deze cmdlet een variabele maakt.

Parametereigenschappen

Type:String
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Value

Hiermee geeft u een waarde voor de variabele.

Parametereigenschappen

Type:Object
Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

Boolean

Object

Uitvoerwaarden

Variable