Partager via


New-AzureRMAutomationVariable

Crée une variable Automation.

Avertissement

Le module AzureRM PowerShell a été officiellement déprécié le 29 février 2024. Les utilisateurs sont invités à migrer d’AzureRM vers le module Az PowerShell afin de s’assurer d’une prise en charge et des mises à jour continues.

Il est possible que le module AzureRM fonctionne encore, mais il ne fait plus l’objet de maintenance ni de support. L’utilisateur peut continuer à s’en servir s’il le souhaite, à ses propres risques. Consultez nos ressources sur la migration pour obtenir des conseils sur la transition vers le module Az.

Syntaxe

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

Description

L’applet de commande New-AzureRmAutomationVariable crée une variable dans Azure Automation. Pour chiffrer la variable, spécifiez le paramètre Encrypted . Vous ne pouvez pas modifier l’état chiffré d’une variable après la création.

Exemples

Exemple 1 : Créer une variable avec une valeur simple

PS C:\>New-AzureRmAutomationVariable -AutomationAccountName "Contoso17" -Name "StringVariable22" -Encrypted $False -Value "My String" -ResourceGroupName "ResourceGroup01"

Cette commande crée une variable nommée StringVariable22 avec une valeur de chaîne dans le compte Automation nommé Contoso17.

Exemple 2 : Créer une variable avec une valeur complexe

PS C:\>$VirtualMachine = Get-AzureVM -ServiceName "VirtualMachine" -Name "VirtualMachine03"
PS C:\> New-AzureRmAutomationVariable -AutomationAccountName "Contoso17" -Name "ComplexVariable01" -Encrypted $False -Value $VirtualMachine -ResourceGroupName "ResourceGroup01"

La première commande obtient une machine virtuelle à l’aide de l’applet de commande Get-AzureVM. La commande la stocke dans la variable $VirtualMachine. La deuxième commande crée une variable nommée ComplexVariable01 dans le compte Automation nommé Contoso17. Cette commande utilise un objet complexe pour sa valeur, dans ce cas, la machine virtuelle dans $VirtualMachine.

Paramètres

-AutomationAccountName

Spécifie le nom du compte Automation dans lequel stocker la variable.

Type:String
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Description

Spécifie une description de la variable.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Encrypted

Spécifie si cette applet de commande chiffre la valeur de la variable pour le stockage.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie un nom pour la variable.

Type:String
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ResourceGroupName

Spécifie le groupe de ressources pour lequel cette applet de commande crée une variable.

Type:String
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Value

Spécifie une valeur pour la variable.

Type:Object
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

Entrées

String

Boolean

Object

Sorties

Variable