Partager via

Get-Variable

Module:
Microsoft.PowerShell.Utility Module

Obtient les variables dans la console active.

Syntaxe

Default (Par défaut) 

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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

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

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

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

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-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 (de 0 jusqu'au nombre total 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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ValueOnly

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

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, ce cmdlet 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 commande Get-Variable entre parenthèses.

Notes

Windows PowerShell inclut les alias suivants pour Get-Variable:

  • 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 d’environnement.