Get-Variable
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
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: | Local |
| 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: | False |
| 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 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 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.