about_Environment_Provider
Nom du fournisseur
Environnement
Lecteurs
Env:
Fonctionnalités
ShouldProcess
Description courte
Fournit l'accès aux variables d'environnement Windows.
Description détaillée
Le fournisseur d’environnement PowerShell vous permet d’obtenir, d’ajouter, de modifier, d’effacer et de supprimer des variables et des valeurs d’environnement dans PowerShell.
Les variables d’environnement sont des variables nommées dynamiquement qui décrivent l’environnement dans lequel vos programmes s’exécutent. Windows et PowerShell utilisent des variables d’environnement pour stocker des informations persistantes qui affectent l’exécution du système et du processus. Contrairement aux variables PowerShell, les variables d’environnement ne sont pas soumises à des contraintes d’étendue.
Le lecteur d’environnement est un espace de noms plat contenant les variables d’environnement spécifiques à la session de l’utilisateur actuel. Les variables d’environnement n’ont aucun élément enfant.
Le fournisseur d’environnement prend en charge les applets de commande suivantes, qui sont abordées dans cet article.
Types exposés par ce fournisseur
Chaque variable d’environnement est une instance de la classe System.Collections.DictionaryEntry . Le nom de la variable est la clé du dictionnaire. La valeur de la variable d'environnement est la valeur du dictionnaire.
Navigation dans le lecteur d’environnement
Le fournisseur d’environnement expose son magasin de données dans le Env: lecteur. Pour utiliser des variables d’environnement, remplacez votre emplacement par le Env: lecteur (Set-Location Env:) ou travaillez à partir d’un autre lecteur PowerShell. Pour référencer une variable d’environnement à partir d’un autre emplacement, utilisez le Env: nom du lecteur dans le chemin d’accès.
Set-Location Env:
Pour revenir à un lecteur du système de fichiers, tapez le nom du lecteur. Par exemple, entrez :
Set-Location C:
Vous pouvez également utiliser le fournisseur d’environnement à partir de n’importe quel autre lecteur PowerShell. Pour référencer une variable d’environnement à partir d’un autre emplacement, utilisez le nom Env: du lecteur dans le chemin d’accès.
Le fournisseur d’environnement expose également des variables d’environnement à l’aide d’un préfixe de variable .$env: La commande suivante affiche le contenu de la variable d’environnement ProgramFiles . Le $env: préfixe de variable peut être utilisé à partir de n’importe quel lecteur PowerShell.
PS C:\> $env:ProgramFiles
C:\Program Files
Vous pouvez également modifier la valeur d’une variable d’environnement à l’aide du $env: préfixe de variable. Toutes les modifications apportées se rapportent uniquement à la session PowerShell actuelle tant qu’elles sont actives.
Remarque
PowerShell utilise des alias pour vous permettre d’utiliser des chemins d’accès de fournisseur familiers. Les commandes telles que dir et ls sont désormais des alias pour Get-ChildItem sont cd un alias pour Set-Location. et pwd est un alias pour Get-Location.
Obtention de variables d’environnement
Cette commande répertorie toutes les variables d’environnement dans la session active.
Get-Item -Path Env:
Vous pouvez utiliser cette commande à partir de n’importe quel lecteur PowerShell.
Le fournisseur d’environnement n’a pas de conteneurs. La commande ci-dessus a donc le même effet quand elle est utilisée avec Get-ChildItem.
Get-ChildItem -Path Env:
Obtenir une variable d’environnement sélectionnée
Cette commande obtient la variable d’environnement WINDIR .
Get-ChildItem -Path Env:windir
Vous pouvez également utiliser le format de préfixe variable.
$env:windir
Créer une variable d’environnement
Cette commande crée la USERMODE variable d’environnement avec la valeur « Non-Administration ». La -Path valeur du paramètre crée le nouvel élément dans le Env: lecteur. La nouvelle variable d’environnement est utilisable uniquement dans la session PowerShell actuelle tant qu’elle est active.
PS C:\> New-Item -Path Env: -Name USERMODE -Value Non-Admin
Modification d’une variable d’environnement
Renommer une variable d’environnement
Cette commande utilise l’applet Rename-Item de commande pour modifier le nom de la USERMODE variable d’environnement que vous avez créée USERROLE. Ne changez 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 provoquer un fonctionnement incorrect du système ou d'un programme.
Rename-Item -Path Env:USERMODE -NewName USERROLE
Modifier une variable d’environnement
Cette commande utilise l’applet Set-Item de commande pour remplacer la valeur de la USERROLE variable d’environnement par « Administration istrator ».
Set-Item -Path Env:USERROLE -Value Administrator
Copier une variable d’environnement
Cette commande copie la valeur de la USERROLE variable d’environnement dans la variable d’environnement USERROLE2 .
Copy-Item -Path Env:USERROLE -Destination Env:USERROLE2
Supprimer une variable d’environnement
Cette commande supprime la USERROLE2 variable d’environnement de la session active.
Remove-Item -Path Env:USERROLE2
Supprimer une variable d’environnement avec Clear-Item
Cette commande supprime la variable d’environnement USERROLE en désactivant sa valeur.
Clear-Item -Path Env:USERROLE
Utilisation du pipeline
Les applets de commande du fournisseur acceptent l’entrée de pipeline. Vous pouvez utiliser le pipeline pour simplifier la tâche en envoyant des données de fournisseur d’une applet de commande à une autre applet de commande du fournisseur. Pour en savoir plus sur l’utilisation du pipeline avec des applets de commande de fournisseur, consultez les références d’applet de commande fournies dans cet article.
Obtenir de l'aide
Depuis Windows PowerShell 3.0, vous pouvez obtenir des rubriques d'aide personnalisées pour les applets de commande du fournisseur, qui expliquent comment ces applets de commande se comportent dans un lecteur du système de fichiers.
Pour obtenir les rubriques d’aide personnalisées pour le lecteur de système de fichiers, exécutez une commande Get-Help dans un lecteur de système de fichiers ou utilisez le -Path paramètre Get-Help pour spécifier un lecteur de système de fichiers.
Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path env:
