RUBRIQUE
    about_Variables

DESCRIPTION COURTE
    Explique comment les variables stockent des valeurs pouvant être 
    utilisées dans Windows PowerShell.  

DESCRIPTION LONGUE
    Une variable est une unité de mémoire dans laquelle des valeurs 
    sont stockées. Dans Windows PowerShell, les variables sont 
    représentées par des chaînes de texte à mot unique qui commencent 
    par le symbole dollar ($), telles que $a, $process ou $my_var.

    Il existe plusieurs types de variables différents dans Windows 
    PowerShell.

    -- Les variables créées par l'utilisateur : les variables créées 
       par l'utilisateur sont créées et gérées par l'utilisateur. Par 
       défaut, les variables que vous créez à partir de la ligne de 
       commande Windows PowerShell existent uniquement pendant que la 
       fenêtre Windows PowerShell est ouverte, et sont perdues 
       lorsque vous fermez la fenêtre. Pour enregistrer une variable, 
       ajoutez-la à votre profil Windows PowerShell. Vous pouvez 
       également créer des variables dans des scripts avec une 
       portée globale, de script ou locale.  

    -- Les variables automatiques : les variables automatiques 
       stockent l'état de Windows PowerShell. Ces variables sont 
       créées par Windows PowerShell, qui modifie leurs valeurs si 
       nécessaire afin de garantir leur exactitude. Les utilisateurs 
       ne peuvent pas modifier la valeur de ces variables. Par exemple, 
       la variable $PSHome stocke le chemin d'accès au répertoire 
       d'installation de Windows PowerShell. Pour obtenir plus 
       d'informations, ainsi qu'une liste et une description des 
       variables automatiques, consultez about_Automatic_Variables.

    -- Les variables de préférence : les variables de préférence 
       stockent les préférences de l'utilisateur pour Windows 
       PowerShell. Ces variables sont créées par Windows PowerShell 
       et sont remplies avec des valeurs par défaut. Les utilisateurs 
       peuvent modifier les valeurs de ces variables. Par exemple, 
       MaximumHistoryCount détermine le nombre maximal d'entrées que 
       peut contenir l'historique de la session. Pour obtenir plus 
       d'informations, ainsi qu'une liste et une description des 
       variables de préférence, consultez about_Preference_Variables.

    
 UTILISATION DES VARIABLES

    Pour répertorier toutes les variables dans votre session Windows 
    PowerShell, tapez :

       get-variable

    Pour afficher la valeur d'une variable donnée, tapez le nom 
    de cette variable, précédé d'un symbole dollar ($). Windows 
    PowerShell répond en affichant sa valeur.

       $<nom-variable>

    Par exemple :

        PS> $pshome
        C:\Windows\System32\WindowsPowerShell\v1.0


    Pour créer une nouvelle variable ou modifier la valeur d'une 
    variable, utilisez une instruction d'assignation au format suivant :

        $<variable> = <valeur>

    Par exemple :

        PS> $my-variable = 1, 2, 3

        ou

        PS> $VerbosePreference = "Continuer"

    Pour obtenir un objet qui représente la variable, utilisez une 
    commande Get-Variable, par exemple :

        PS> get-variable pid


    Pour utiliser une variable, tapez son nom, y compris le symbole 
    dollar ($), dans une commande ou expression. Si la commande ou 
    l'expression n'est pas placée entre guillemets ou si elle est 
    placée entre guillemets doubles ("), la valeur de la variable est 
    utilisée dans la commande ou l'expression. Si la commande est 
    placée entre guillemets simples ('), le nom de la variable est 
    utilisé dans l'expression.

    Par exemple, la première commande recherche la valeur de la 
    variable $profile, qui est le chemin d'accès au fichier de profil 
    utilisateur Windows PowerShell. La seconde commande ouvre le 
    fichier dans le Bloc-notes.

        PS> $profile
        C:\Documents and Settings\Utilisateur01\Mesdocuments\WindowsPowerShell\Microsoft.PowerShell_profile.ps1

        PS> Notepad $profile


    Vous pouvez stocker n'importe quel type d'objet dans une 
    variable, notamment des entiers, des chaînes, des tableaux, des 
    tables de hachage, ainsi que des objets qui représentent des 
    processus, des services, des journaux des événements et des 
    ordinateurs.  
  

  ENREGISTREMENT DE VARIABLES
      Les variables que vous créez sont disponibles uniquement dans 
      la session dans laquelle vous les créez. Elles sont perdues 
      lorsque vous fermez votre session.
     
      Pour enregistrer une variable, ajoutez-la à votre profil 
      Windows PowerShell.
      Les variables stockées dans un profil sont ajoutées à chaque 
      session Windows PowerShell que vous ouvrez.

      Par exemple, pour modifier la valeur de la variable 
      $VerbosePreference dans chaque session Windows PowerShell, 
      ajoutez la commande suivante à votre profil Windows PowerShell.

	  $VerbosePreference = "Continuer"

      Vous pouvez ajouter cette commande à votre profil en ouvrant le 
      fichier de profil dans un éditeur de texte, tel que le 
      Bloc-notes, ou vous pouvez utiliser une commande Add-Content, 
      comme ci-dessous.

      La commande suivante ajoute la nouvelle valeur de la variable 
      $VerbosePreference au profil CurrentUser,AllHosts.

	  add-content -path $profile.CurrentUserAllHosts -value '$VerbosePreference = "Continuer"'

      Pour plus d'informations sur les profils Windows PowerShell, 
      consultez about_profiles.


 NOMS DE VARIABLES COMPORTANT DES CARACTÈRES SPÉCIAUX

    Vous pouvez utiliser des accolades pour forcer Windows PowerShell 
    à interpréter un nom de variable de manière littérale. Cela est 
    particulièrement utile lors de la création d'un nom de variable 
    ou de la référence à un nom de variable qui inclut des caractères 
    spéciaux, tels que des tirets, des points, des deux-points et des 
    parenthèses. 

    Pour créer un nom de variable qui inclut un trait d'union, placez 
    ce nom entre accolades. La commande suivante crée une variable 
    nommée " save-items ".

        C:\PS> ${save-items} = "a", "b", "c"
        C:\PS>${save-items}
        a
        b
        c

    Pour référencer un nom de variable qui inclut des parenthèses, 
    placez ce nom entre accolades. 

    Par exemple, la commande suivante place les éléments enfants des 
    magasins d'annuaires dans la variable d'environnement 
    " ProgramFiles(x86) ".

        C:\PS> Get-childitem ${env:ProgramFiles(x86)}


    Pour référencer un nom de variable qui inclut des accolades, 
    placez ce nom entre accolades et utilisez le caractère backtick 
    (échappement) pour ignorer les accolades. Par exemple, pour créer 
    une variable nommée " this{value}is " ayant la valeur 1, tapez : 

        C:\PS> ${this`{value`}is} = 1
        C:\PS> ${this`{value`}is}
        1


 LE LECTEUR VARIABLE:

     Windows PowerShell inclut un lecteur Variable: qui se présente 
     et agit comme un lecteur de système de fichiers, mais qui 
     contient les variables de votre session. 

     Pour accéder au lecteur Variable, tapez :

        set-location variable:
        
         (ou " cd variable: ")

     
     Une fois sur le lecteur Variable, pour répertorier les éléments 
     (variables) qu'il contient, utilisez l'applet de commande 
     Get-ChildItem. Par exemple :

         get-childitem

         (ou bien " dir " ou " ls ")
     
     Pour plus d'informations sur le lecteur Variable: et sur le 
     fournisseur Variable de Windows PowerShell, tapez :

         get-help variable


VOIR AUSSI
    about_Automatic_Variables
    about_Environment_Variables
    about_Preference_Variables
    about_Scopes




Table des matières