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