Partager via

Get-Variable

  • Référence
Module:
Microsoft.PowerShell.Utility

Obtient les variables dans la console active.

Syntax

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 actuelle. Vous pouvez récupérer seulement 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 dont les noms commencent par la lettre m. La commande obtient également la valeur des variables.

Get-Variable m*

Exemple 2 : Obtenir des valeurs variables par lettre

Cette commande obtient uniquement les valeurs des variables dont les noms commencent 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 équivaut à Get-Variable -Scope Local et peut être abrégé en .gv -s 0

La deuxième commande utilise l’applet Compare-Object de commande pour rechercher les variables qui sont définies dans l’étendue parente (étendue 1) mais qui 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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 par le 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ValueOnly

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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 , si la valeur de la variable spécifiée est une collection, Get-Variable 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

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