Nom du fournisseur
Environment
Lecteurs
Env:
Description courte
Donne accès aux variables d'environnement Windows.
Description détaillée
Le fournisseur Environment de Windows PowerShell vous permet d'obtenir, d'ajouter, de modifier, d'effacer et de supprimer des variables d'environnement Windows dans Windows PowerShell.
Il correspond à un espace de noms plat qui contient uniquement les objets représentant les variables d'environnement. Les variables n'ont pas d'éléments enfants.
Chaque variable d'environnement est une instance de la classe System.Collections.DictionaryEntry. Le nom de la variable représente la clé du dictionnaire. La valeur de la variable d'environnement correspond à la valeur de dictionnaire.
Le fournisseur Environment expose son magasin de données sur le lecteur Env:. Pour utiliser les variables d'environnement, redéfinissez votre emplacement pour qu'il corresponde au lecteur Env: (« set-location env: ») ou travaillez à partir d'un autre lecteur Windows PowerShell. Pour référencer une variable d'environnement à partir d'un autre emplacement, utilisez le nom de lecteur Env: dans le chemin d'accès.
Le fournisseur de variables d'environnement prend en charge toutes les applets de commande qui contiennent le nom Item, à l'exception de l'applet de commande Invoke-Item. Il prend également en charge les applets de commande Get-Content et Set-Content. Toutefois, il ne prend pas en charge les applets de commande contenant le nom ItemProperty et n'accepte le paramètre Filter dans aucune applet de commande.
Les variables d'environnement doivent respecter les normes d'affectation de noms habituelles. En outre, le nom ne peut pas inclure le signe égal (=).
Les modifications apportées aux variables d'environnement affectent uniquement la session active. Pour enregistrer les modifications apportées, ajoutez-les au profil Windows PowerShell ou utilisez Export-Console pour enregistrer la session active.
Exemples
Accès au lecteur Env:
-------------------------- EXEMPLE 1 --------------------------
La commande suivante redéfinit l'emplacement actuel pour qu'il corresponde au lecteur Env: :
set-location env:
Vous pouvez utiliser cette commande depuis n'importe quel lecteur dans Windows PowerShell. Pour revenir à un lecteur de système de fichiers, tapez le nom du lecteur. Par exemple, tapez : set-location c:
Obtention de variables d'environnement
-------------------------- EXEMPLE 1 --------------------------
La commande suivante répertorie toutes les variables d'environnement de la session active :
get-childitem -path env:
Vous pouvez utiliser cette commande depuis n'importe quel lecteur Windows PowerShell.
-------------------------- EXEMPLE 2 --------------------------
La commande suivante permet d'obtenir la variable d'environnement WINDIR :
get-childitem -path env:windir
-------------------------- EXEMPLE 3 --------------------------
La commande suivante permet d'obtenir une liste de toutes les variables d'environnement de la session active, puis de les trier par nom :
get-childitem | sort-object -property name
Par défaut, les variables d'environnement apparaissent dans l'ordre dans lequel Windows PowerShell les découvre. Cette commande est envoyée sur le lecteur Env:. Lorsque vous exécutez cette commande à partir d'un autre lecteur, ajoutez le paramètre Path avec la valeur Env:.
Création d'une variable d'environnement
-------------------------- EXEMPLE 1 --------------------------
La commande suivante crée la variable d'environnement USERMODE avec la valeur Non-Admin :
new-item -path . -name USERMODE -value Non-Admin
L'emplacement actuel étant situé sur le lecteur Env:, la valeur du paramètre Path est un point (.). Le point représente l'emplacement actuel. Si vous ne vous trouviez pas sur le lecteur Env:, la valeur du paramètre Path serait Env:.
Affichage des propriétés et méthodes des variables d'environnement
-------------------------- EXEMPLE 1 --------------------------
La commande suivante utilise l'applet de commande Get-ChildItem pour obtenir toutes les variables d'environnement :
get-childitem -path env: | get-member
L'opérateur de pipeline (|) envoie les résultats à Get-Member, qui affiche les méthodes et propriétés de l'objet. Lorsque vous dirigez une collection d'objets vers Get-Member, telle que la collection de variables d'environnement du lecteur Env:, Get-Member évalue chaque objet de la collection séparément. Get-Member retourne ensuite les informations relatives à chaque type d'objet trouvé. Si tous les objets sont de même type, elle retourne les informations relatives à ce type d'objet. Dans le cas présent, toutes les variables d'environnement correspondent à des objets DictionaryEntry. Pour obtenir des informations sur la collection d'objets DictionaryEntry, faites appel au paramètre InputObject de Get-Member. Par exemple, tapez : get-member -inputobject (get-childitem env:) Lorsque vous utilisez le paramètre InputObject, Get-Member évalue la collection, et non pas les objets qu'elle contient.
-------------------------- EXEMPLE 2 --------------------------
La commande suivante répertorie les valeurs des propriétés de la variable d'environnement WINDIR :
get-item env:windir | format-list -property *
Elle utilise l'applet de commande Get-Item pour obtenir un objet qui représente la variable d'environnement WINDIR. L'opérateur de pipeline (|) envoie les résultats à la commande Format-List. Elle utilise le paramètre Property avec un caractère générique (*) afin de mettre en forme et d'afficher les valeurs de toutes les propriétés de la variable d'environnement WINDIR.
Modification des propriétés d'une variable d'environnement
-------------------------- EXEMPLE 1 --------------------------
La commande suivante utilise l'applet de commande Rename-Item pour remplacer le nom de la variable d'environnement USERMODE que vous avez créée par USERROLE :
rename-item -path env:USERMODE -newname USERROLE
Cette modification affecte les propriétés Name, Key et PSPath de l'objet DictionaryEntry. Ne modifiez pas le nom d'une variable d'environnement utilisée par le système. Bien que ces modifications affectent uniquement la session active, elles peuvent entraîner le dysfonctionnement du système ou d'un programme.
-------------------------- EXEMPLE 2 --------------------------
La commande suivante utilise l'applet de commande Set-Item pour remplacer la valeur de la variable d'environnement USERROLE par Administrator :
set-item -path env:USERROLE -value Administrator
Copie d'une variable d'environnement
-------------------------- EXEMPLE 1 --------------------------
La commande suivante copie la valeur de la variable d'environnement USERROLE dans la variable d'environnement USERROLE2 :
copy-item -path env:USERROLE -destination env:USERROLE2
Suppression d'une variable d'environnement
-------------------------- EXEMPLE 1 --------------------------
La commande suivante supprime la variable d'environnement USERROLE2 de la session active :
remove-item -path env:USERROLE2
Vous pouvez l'utiliser sur n'importe quel lecteur Windows PowerShell. Si vous vous trouvez sur le lecteur Env:, vous pouvez omettre le nom du lecteur dans le chemin d'accès.
-------------------------- EXEMPLE 2 --------------------------
La commande suivante supprime la variable d'environnement USERROLE.
clear-item -path env:USERROLE
Voir aussi