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 Get-Variable de commande obtient les variables PowerShell dans la console active. 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 seulement les variables définies dans l'étendue locale. Il est équivalent à Get-Variable -Scope Local et peut être abrégé en tant que gv -s 0.

La deuxième commande utilise l’applet Compare-Object de commande 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 cette applet de commande.

Sorties

PSVariable

Par défaut, cette applet de commande retourne un objet 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 et que la valeur de la variable spécifiée est une collection, cette applet de commande retourne un [System.Object[]]. 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 Get-Variable commande entre parenthèses.

Notes

PowerShell inclut les alias suivants pour Get-Variable:

  • Toutes les plateformes :

    • gv

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