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’extraire, d’ajouter, de modifier, d’effacer et de supprimer des variables d’environnement et des valeurs 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 des processus. Contrairement aux variables PowerShell, les variables d’environnement ne sont pas soumises aux contraintes de portée.

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.

Le fournisseur d' environnement expose son magasin de données dans le Env: lecteur. Pour utiliser des variables d’environnement, modifiez votre emplacement sur 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 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 de l' 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 du lecteur Env: dans le chemin d’accès.

Le fournisseur d' environnement expose également les variables d’environnement à l’aide d’un préfixe variable de $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 active tant qu’elle est active.

Notes

PowerShell utilise des alias pour vous permettre de travailler de façon familière avec les chemins d’accès des fournisseurs. Les commandes telles que dir et ls sont maintenant des alias pour l’expression « obtenir-ChildItem », cd est un alias pour set-location. et pwd est un alias pour la récupération de l' emplacement.

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, donc 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 WINDIR variable d’environnement.

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 USERMODE variable d’environnement avec la valeur « non-admin ». 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 active 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' Rename-Item applet 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' Set-Item applet de commande pour modifier la valeur de la USERROLE variable d’environnement en « Administrator ».

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 USERROLE2 variable d’environnement.

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 USERROLE variable d’environnement en effaçant sa valeur.

Clear-Item -Path Env:USERROLE

Utilisation du pipeline

Les applets de commande du fournisseur acceptent l’entrée du pipeline. Vous pouvez utiliser le pipeline pour simplifier la tâche en envoyant les données du fournisseur d’une applet de commande à une autre applet de commande du fournisseur. Pour en savoir plus sur l’utilisation du pipeline avec les applets de commande du fournisseur, consultez les références des applets de commande fournies dans cet article.

Obtention d’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 du système de fichiers, exécutez une commande obtenir-Help dans un lecteur du système de fichiers ou utilisez le -Path paramètre de la commande obtenir-Help pour spécifier un lecteur du système de fichiers.

Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path env:

Voir aussi

about_Providers