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 pas d’éléments enfants.
Le fournisseur d’environnement prend en charge les applets de commande suivantes, qui sont traité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 utilisez un autre lecteur PowerShell. Pour référencer une variable d’environnement à partir d’un autre emplacement, utilisez le nom du Env: 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 préfixe de $env: variable. Les modifications apportées concernent uniquement la session PowerShell actuelle tant qu’elle est active.
Notes
PowerShell utilise des alias pour vous permettre d’utiliser les chemins d’accès du fournisseur. Les commandes telles que dir et ls sont désormais des alias pour Get-ChildItem, cd est 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 de la session active.
Get-Item -Path Env:
Vous pouvez utiliser cette commande à partir de n’importe quel lecteur PowerShell.
Le fournisseur d’environnement n’ayant aucun conteneur, la commande ci-dessus a le même effet lorsqu’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 de variable.
$env:windir
Créer une variable d’environnement
Cette commande crée la variable d’environnement USERMODE avec la valeur « Non Administration ». La -Path valeur du paramètre crée l’é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 remplacer le nom de la USERMODE variable d’environnement que vous avez créée par 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 « Administrateur ».
Set-Item -Path Env:USERROLE -Value Administrator
Copier une variable d’environnement
Cette commande copie la valeur de la variable d’environnement USERROLE dans la variable d’environnement USERROLE2 .
Copy-Item -Path Env:USERROLE -Destination Env:USERROLE2
Supprimer une variable d’environnement
Cette commande supprime la variable d’environnement USERROLE2 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 effaçant sa valeur.
Clear-Item -Path Env:USERROLE
Utilisation du pipeline
Les applets de commande de 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 de fournisseur. Pour en savoir plus sur l’utilisation du pipeline avec les 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: