Get-Variable

NOM
    Get-Variable

RÉSUMÉ
    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 [<SwitchParameter>]
        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, WarningAction, WarningVariable,
        OutBuffer et OutVariable. Pour plus d'informations, tapez
        « get-help about_commonparameters ».

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.


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.


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






LIENS CONNEXES
    Online version: http://go.microsoft.com/fwlink/?LinkID=113336
    Set-Variable
    New-Variable
    Clear-Variable
    Remove-Variable