Get-Variable (Français)

Module: Microsoft.PowerShell.Utility

Obtient les variables de la console actuelle.

Syntaxe

Description

L’applet de commande Get-Variable obtient les variables PowerShell dans la console actuelle. Vous pouvez récupérer uniquement les valeurs des variables en spécifiant le paramètre ValueOnly, et vous pouvez filtrer les variables renvoyées par nom.

Exemples

Exemple 1 : Obtenir les variables par lettre

Cette commande récupère les variables dont le nom commence par la lettre m. La commande récupère également la valeur des variables.

Exemple 2: Obtenir les valeurs des variables par lettre

Cette commande obtient uniquement les valeurs des variables dont les noms commencent par m.

Exemple 3: Obtenir des variables par deux lettres

Cette commande obtient des informations sur les variables qui commencent par la lettre M ou la lettreP .

Exemple 4: Obtenir des variables par portée

La première commande ne récupère que les variables qui sont définies dans la portée locale. équivaut à Get-Variable -Scope Local et peut être abrégé en gv -s 0.

La deuxième commande utilise Compare-Object cmdlet pour rechercher les variables définies dans la portée parent (Scope 1) mais visibles uniquement dans la portée locale (Scope 0).

Paramètres

-Exclude

Spécifie un tableau d’éléments que cette applet de commande exclut de l’opération. Les cartes sauvages sont autorisées.

Type: Chaîne
Position: Nommé
Valeur par défaut: Aucune
Accepter l’entrée de pipeline: False
Accepter les caractères génériques: Vrai
-Include

Spécifie un tableau y des éléments sur lesquels l’applet de commande agira, à l’exclusion de tous les autres. Les cartes sauvages sont autorisées.

Type: Chaîne
Position: Nommé
Valeur par défaut: Aucun
Accepter l’entrée du pipeline: Faux
Accepter les caractères génériques: True
-Name

Spécifie le nom de la variable. Les cartes sauvages sont autorisées .Vous pouvez également diriger un nom de variable vers Get-Variable.

Type: Chaîne
Position: 0
Valeur par défaut: Aucun
Accepter l’entrée du pipeline: Vrai
Accepter les caractères génériques: True
-Scope

Spécifie les variables dans la portée . Les valeurs acceptables pour ce paramètre sont:

  • Global
  • Local
  • Script
  • Un nombre relatif à la portée actuelle (0 à travers le nombre de portées, où 0 est la portée actuelle et 1 est son parent)

Local est la valeur par défaut. Pour plus d’informations, consultez about_Scopes.

Type: Chaîne
Position: Nommé
Valeur par défaut : Aucun
Accepter l’entrée du pipeline: Faux
Accepter caractères génériques: Faux
-ValueOnly

Indique que cette applet de commande obtient uniquement la valeur de la variable.

Type: SwitchParameter
Position: Nommé
Valeur par défaut: Aucun
Accepter l’entrée du pipeline: Faux
Accepter les caractères génériques: Faux

Entrées

Chaîne

Vous pouvez diriger une chaîne contenant le nom de la variable vers Get-Variable.

Sorties

PSVariable

Cette applet de commande renvoie un objet System.Management.AutomationPSVariable pour chaque variable qu’elle engendre. Le type d’objet dépend de la variable.

Objet

Lorsque vous spécifiez le paramètre ValueOnly, si la valeur de la variable spécifiée est une collection, Get-Variable renvoie un ]. Ce comportement empêche le fonctionnement normal du pipeline de traiter les valeurs de la variable une par une. Une solution de contournement pour forcer l’énumération de collection consiste à fermer la commande Get-Variable entre parenthèses.

Remarques

  • Cette applet de commande ne gère pas les variables d’environnement . Pour gérer les variables d’environnement, vous pouvez utiliser le fournisseur de variables d’environnement.
  • Clear-Variable
  • New-Variable
  • Remove-Variable
  • Set-Variable

Write a Comment

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *