Get-Variable
Obtient les variables de la console actuelle.
Syntaxe
Get-Variable [[-Name] <string[]>] [-Exclude <string[]>] [-Include <string[]>] [-Scope <string>] [-ValueOnly] [<CommonParameters>]
Description
L'applet de commande Get-Variable obtient les variables Windows PowerShell de 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.
Paramètres
-Exclude <string[]>
Omet les éléments spécifiés. Les caractères génériques sont autorisés.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Include <string[]>
Spécifie uniquement les éléments affectés par l'applet de commande, en excluant tous les autres. Les caractères génériques sont autorisés.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Name <string[]>
Spécifie le nom de la variable.
Obligatoire ? |
false |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Scope <string>
Obtient uniquement les variables de la portée spécifiée. Les valeurs valides sont « Global », « Local » ou « Script », ou un nombre relatif à la portée actuelle (0 jusqu'au nombre de portées, où 0 est la portée actuelle et 1 son parent). « Local » est la valeur par défaut. Pour plus d'informations, consultez about_Scopes.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-ValueOnly
Obtient uniquement la valeur de la variable.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
Entrées |
System.String Vous pouvez diriger une chaîne contenant le nom de la variable vers Get-Variable. |
Sorties |
Objet variable Get-Variable retourne un objet variable System.Management.Automation pour chaque variable obtenue. Le type d'objet dépend de la variable. |
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.
Exemple 1
C:\PS>get-variable m*
Description
-----------
Cette commande affiche les variables dont le nom commence par la lettre « m ». La valeur des variables est également affichée.
Exemple 2
C:\PS>get-variable m* -valueonly
Description
-----------
Cette commande affiche uniquement les valeurs des variables dont le nom commence par la lettre « m ».
Exemple 3
C:\PS>get-variable -include M*,P* | sort-object name
Description
-----------
Cette commande obtient des informations sur les variables dont le nom commence par la lettre « M » ou la lettre « P ». Les résultats sont dirigés vers l'applet de commande Sort-Object, triés par nom, puis affichés.
Exemple 4
C:\PS>get-variable -scope 0
C:\PS> compare-object (get-variable -scope 0) (get-variable -scope 1)
Description
-----------
La première commande obtient uniquement les variables définies dans la portée locale. Elle est équivalente à la commande « get-variable -scope local » et peut être abrégée en « gv -s 0 ».
La deuxième commande utilise l'applet de commande Compare-Object pour rechercher les variables définies dans la portée parente (Scope 1), mais qui sont uniquement visibles dans la portée locale (Scope 0).