about_Environment_Provider
Anbietername
Environment
Laufwerke
Env:
Funktionen
ShouldProcess
Kurze Beschreibung
Bietet Zugriff auf die Windows-Umgebungsvariablen.
Detaillierte Beschreibung
Mit dem PowerShell-Umgebungsanbieter können Sie Umgebungsvariablen und -werte in PowerShell abrufen, hinzufügen, ändern, löschen und löschen.
Umgebungsvariablen sind dynamisch benannte Variablen, die die Umgebung beschreiben, in der Ihre Programme ausgeführt werden. Windows und PowerShell verwenden Umgebungsvariablen, um persistente Informationen zu speichern, die sich auf die System- und Prozessausführung auswirken. Im Gegensatz zu PowerShell-Variablen unterliegen Umgebungsvariablen keinen Bereichseinschränkungen.
Das Umgebungslaufwerk ist ein flacher Namespace, der die Umgebungsvariablen enthält, die für die aktuelle Benutzersitzung spezifisch sind. Die Umgebungsvariablen enthalten keine untergeordneten Elemente.
Der Umgebungsanbieter unterstützt die folgenden Cmdlets, die in diesem Artikel behandelt werden.
Typen, die von diesem Anbieter verfügbar gemacht werden
Jede Umgebungsvariable ist eine instance der System.Collections.DictionaryEntry-Klasse. Der Name der Variablen ist der Wörterbuchschlüssel. Der Wert der Umgebungsvariablen ist der Wörterbuchwert.
Navigieren auf dem Laufwerk "Umgebung"
Der Umgebungsanbieter macht seinen Datenspeicher auf dem Env:
Laufwerk verfügbar. Um mit Umgebungsvariablen zu arbeiten, ändern Sie Ihren Standort in das Env:
Laufwerk (Set-Location Env:
), oder arbeiten Sie von einem anderen PowerShell-Laufwerk aus. Um von einem anderen Speicherort aus auf eine Umgebungsvariable zu verweisen, verwenden Sie den Namen des Env:
Laufwerks im Pfad.
Set-Location Env:
Um zu einem Dateisystemlaufwerk zurückzukehren, geben Sie den Namen des Laufwerks ein. Beispiel:
Set-Location C:
Sie können auch von jedem anderen PowerShell-Laufwerk aus mit dem Umgebungsanbieter arbeiten. Um von einem anderen Speicherort aus auf eine Umgebungsvariable zu verweisen, verwenden Sie den Namen des Laufwerks Env:
im Pfad.
Der Umgebungsanbieter macht auch Umgebungsvariablen mit dem Variablenpräfix verfügbar $env:
. Mit dem folgenden Befehl werden die Inhalte der Umgebungsvariable ProgramFiles angezeigt. Das $env:
Variablenpräfix kann von jedem PowerShell-Laufwerk aus verwendet werden.
PS C:\> $env:ProgramFiles
C:\Program Files
Sie können auch den Wert einer Umgebungsvariablen mithilfe des $env:
Variablenpräfixes ändern. Alle vorgenommenen Änderungen beziehen sich nur auf die aktuelle PowerShell-Sitzung, solange sie aktiv ist.
Hinweis
PowerShell verwendet Aliase, um Ihnen eine vertraute Methode zum Arbeiten mit Anbieterpfaden zu ermöglichen. Befehle wie dir
und ls
sind jetzt Aliase für Get-ChildItem, cd
ist ein Alias für Set-Location. und pwd
ist ein Alias für Get-Location.
Abrufen von Umgebungsvariablen
Dieser Befehl listet alle Umgebungsvariablen in der aktuellen Sitzung auf.
Get-Item -Path Env:
Sie können diesen Befehl von jedem PowerShell-Laufwerk aus verwenden.
Der Umgebungsanbieter verfügt über keine Container, sodass der obige Befehl die gleiche Auswirkung hat, wenn er mit Get-ChildItem
verwendet wird.
Get-ChildItem -Path Env:
Abrufen einer ausgewählten Umgebungsvariablen
Mit diesem Befehl wird die Umgebungsvariable WINDIR
abgerufen.
Get-ChildItem -Path Env:windir
Sie können auch das Variablenpräfixformat verwenden.
$env:windir
Erstellen einer Umgebungsvariablen
Mit diesem Befehl wird die Umgebungsvariable USERMODE
mit dem Wert "Nicht Admin" erstellt. Der -Path
Parameterwert erstellt das neue Element im Env:
Laufwerk. Die neue Umgebungsvariable kann nur solange in der aktuellen PowerShell-Sitzung verwendet werden, wie sie aktiv ist.
PS C:\> New-Item -Path Env: -Name USERMODE -Value Non-Admin
Ändern einer Umgebungsvariable
Umbenennen einer Umgebungsvariablen
Dieser Befehl verwendet das Rename-Item
Cmdlet, um den Namen der USERMODE
von Ihnen erstellten Umgebungsvariablen in zu USERROLE
ändern. Ändern Sie nicht den Namen einer Umgebungsvariablen, die das System verwendet. Obwohl diese Änderungen nur die aktuelle Sitzung betreffen, bewirken sie möglicherweise, dass das System oder ein Programm nicht korrekt arbeitet.
Rename-Item -Path Env:USERMODE -NewName USERROLE
Ändern einer Umgebungsvariable
Dieser Befehl verwendet das Set-Item
Cmdlet, um den Wert der USERROLE
Umgebungsvariablen in "Administrator" zu ändern.
Set-Item -Path Env:USERROLE -Value Administrator
Kopieren einer Umgebungsvariablen
Mit diesem Befehl wird der Wert der USERROLE
Umgebungsvariablen in die Umgebungsvariable USERROLE2
kopiert.
Copy-Item -Path Env:USERROLE -Destination Env:USERROLE2
Entfernen einer Umgebungsvariablen
Mit diesem Befehl wird die USERROLE2
Umgebungsvariable aus der aktuellen Sitzung gelöscht.
Remove-Item -Path Env:USERROLE2
Entfernen einer Umgebungsvariable mit Clear-Item
Dieser Befehl löscht die USERROLE
Umgebungsvariable, indem ihr Wert gelöscht wird.
Clear-Item -Path Env:USERROLE
Verwenden der Pipeline
Anbieter-Cmdlets akzeptieren Pipelineeingaben. Sie können die Pipeline verwenden, um die Aufgabe zu vereinfachen, indem Sie Anbieterdaten von einem Cmdlet an ein anderes Anbieter-Cmdlet senden. Weitere Informationen zur Verwendung der Pipeline mit Anbieter-Cmdlets finden Sie in den Cmdlet-Verweisen in diesem Artikel.
Hilfe
Ab Windows PowerShell 3.0 können Sie benutzerdefinierte Hilfethemen für Anbieter-Cmdlets abrufen, die erläutern, wie sich diese Cmdlets in einem Dateisystemlaufwerk verhalten.
Um die Hilfethemen abzurufen, die für das Dateisystemlaufwerk angepasst sind, führen Sie einen Get-Help-Befehl in einem Dateisystemlaufwerk aus, oder verwenden Sie den -Path
Parameter von Get-Help , um ein Dateisystemlaufwerk anzugeben.
Get-Help Get-ChildItem
Get-Help Get-ChildItem -Path env: