Partager via


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.

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:

Voir aussi