Partager via

Get-Variable

  • Référence
Module:
Microsoft.PowerShell.Utility

Obtient les variables dans la console active.

Syntaxe

Get-Variable
   [[-Name] <String[]>]
   [-ValueOnly]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

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 retournées par nom.

Exemples

Exemple 1 : Obtenir des variables par lettre

Cette commande obtient des variables avec des noms commençant par la lettre m. La commande obtient également la valeur des variables.

Get-Variable m*

Exemple 2 : Obtenir des valeurs de variable par lettre

Cette commande obtient uniquement les valeurs des variables qui ont des noms commençant par m.

Get-Variable m* -ValueOnly

Exemple 3 : Obtenir des variables par deux lettres

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

Get-Variable -Include M*,P*

Exemple 4 : Obtenir des variables par étendue

La première commande obtient uniquement les variables définies dans l’étendue locale. Elle équivaut à Get-Variable -Scope Local et peut être abrégée comme gv -s 0.

La deuxième commande utilise l’applet de commande Compare-Object pour rechercher les variables définies dans l’étendue parente (Étendue 1), mais elles sont visibles uniquement dans l’étendue locale (Étendue 0).

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

Paramètres

-Exclude

Spécifie un tableau d’éléments que cette applet de commande exclut de l’opération. Les caractères génériques sont autorisés.

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

-Include

Spécifie un tableau d’éléments sur lesquels l’applet de commande agit, à l’exclusion de tous les autres. Les caractères génériques sont autorisés.

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

-Name

Spécifie le nom de la variable. Les caractères génériques sont autorisés. Vous pouvez également diriger un nom de variable vers Get-Variable.

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

-Scope

Spécifie les variables dans l’étendue. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • global
  • local
  • script
  • Nombre relatif à l’étendue actuelle (0 au nombre d’étendues, où 0 est l’étendue actuelle et 1 est son parent)

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

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

-ValueOnly

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

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

Entrées

String

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

Sorties

PSVariable

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

Object[]

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

Notes

  • 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.