Freigeben über


Grundlegendes zu PSModulePath

Kurze Beschreibung

In diesem Artikel werden der Zweck und die Verwendung der $env:PSModulePath Umgebungsvariable beschrieben.

Lange Beschreibung

Die $env:PSModulePath Umgebungsvariable enthält eine Liste der Ordnerspeicherorte, die durchsucht werden, um Module und Ressourcen zu finden. PowerShell durchsucht rekursiv jeden Ordner nach Moduldateien (.psd1 oder .psm1) Dateien.

Install-Module verfügt über einen Bereichsparameter , mit dem Sie angeben können, ob das Modul für den aktuellen Benutzer oder für alle Benutzer installiert ist. Weitere Informationen finden Sie unter Install-Module.

Standardmäßig sind die zugewiesenen $env:PSModulePath effektiven Speicherorte:

  • Systemweite Speicherorte: Diese Ordner enthalten Module, die mit PowerShell ausgeliefert werden. Diese Module werden im $PSHOME\Modules Ordner gespeichert.

    • Unter Windows werden Module, die im Bereich "AllUsers " installiert sind, in gespeichert $env:ProgramFiles\WindowsPowerShell\Modules.
    • Auf Nicht-Windows-Systemen werden Module, die im Bereich "AllUsers " installiert sind, gespeichert /usr/local/share/powershell/Modules.
  • Vom Benutzer installierte Module: Unter Windows werden module, die im CurrentUser-Bereich installiert sind, in der $HOME\Documents\WindowsPowerShell\Modules Regel im Ordner gespeichert. Der spezifische Speicherort des Documents Ordners variiert je nach Windows-Version und wenn Sie die Ordnerumleitung verwenden. Außerdem kann Microsoft OneDrive den Speicherort Ihres Documents Ordners ändern. Sie können den Speicherort Ihres Documents Ordners mit dem folgenden Befehl überprüfen: [Environment]::GetFolderPath('MyDocuments')

    Auf Nicht-Windows-Systemen werden module, die im CurrentUser-Bereich installiert sind, im $HOME/.local/share/powershell/Modules Ordner gespeichert.

  • Anwendungsspezifische Module: Setupprogramme können Module in anderen Verzeichnissen installieren, z. B. den Program Files Ordner unter Windows. Das Installer-Paket kann den Speicherort an die $env:PSModulePathDatei anfügen.

PowerShell PSModulePath-Konstruktion

Der Wert wird $env:PSModulePath jedes Mal erstellt, wenn PowerShell gestartet wird. Der Wert variiert je nach Version von PowerShell und dem Start.

Windows PowerShell-Start

Windows PowerShell verwendet die folgende Logik, um den PSModulePath Start zu erstellen:

  • Wenn PSModulePath nicht vorhanden, kombinieren Sie CurrentUser, AllUsers und die $PSHOME Modulpfade.
  • Falls PSModulePath vorhanden:
    • $PSHOME Enthält PSModulePath Modulpfad:
      • Der Pfad für AllUsers-Module wird vor dem $PSHOME Modulpfad eingefügt.
    • oder:
      • Verwenden PSModulePath Sie einfach wie definiert, da der Benutzer den Speicherort absichtlich entfernt hat $PSHOME .

Der Pfad des CurrentUser-Moduls wird nur vorangestellt, wenn der Benutzerbereich $env:PSModulePath nicht vorhanden ist. Andernfalls wird der Benutzerbereich $env:PSModulePath wie definiert verwendet.

PowerShell 7-Start

Bei den meisten Umgebungsvariablen verwendet ein neuer Prozess für die meisten Umgebungsvariablen diesen Wert nur, wenn eine Variable mit Computerbereich mit demselben Namen vorhanden ist.

In PowerShell 7 PSModulePath wird ähnlich behandelt wie die Path Umgebungsvariable unter Windows behandelt wird. Unter Windows Path wird anders behandelt als andere Umgebungsvariablen. Wenn ein Prozess gestartet wird, kombiniert Windows den vom Benutzer definierten Path Bereich mit dem Computerbereich Path.

  • Abrufen des Benutzerbereichs PSModulePath
  • Vergleich mit verarbeiteter geerbter Umgebungsvariable PSModulePath
    • Wenn dies derselbe ist:
      • Anfügen der AllUsers PSModulePath an das Ende nach der Semantik der Path Umgebungsvariable
      • Der Windows-Pfad System32 stammt vom definierten PSModulePath Computer, muss daher nicht explizit hinzugefügt werden.
    • Wenn anders, behandeln Sie es, als ob der Benutzer sie explizit geändert hat, und fügen Sie "AllUsers" nicht an PSModulePath
  • Präfix mit PS7-Benutzer, System und $PSHOME Pfaden in dieser Reihenfolge
    • Wenn powershell.config.json ein Benutzer einen Bereich PSModulePathhat, verwenden Sie dies anstelle der Standardeinstellung für den Benutzer.
    • Wenn powershell.config.json ein Systembereich enthalten PSModulePathist, verwenden Sie dies anstelle der Standardeinstellung für das System.

Unix-Systeme haben keine Trennung von Benutzer- und Systemumgebungsvariablen. PSModulePath wird geerbt, und die PS7-spezifischen Pfade werden vorangestellt, wenn sie noch nicht definiert sind.

Starten von Windows PowerShell aus PowerShell 7

Für diese Diskussion bedeutet Windows PowerShell sowohl als powershell_ise.exeauch powershell.exe .

Der Wert der $env:PSModulePath Datei wird mit den folgenden Änderungen kopiert WinPSModulePath :

  • Entfernen des PS7-Pfads des Benutzermoduls
  • Entfernen sie PS7 den Systemmodulpfad.
  • Entfernen von PS7 des Modulpfads $PSHOME

Die PS7-Pfade werden entfernt, sodass PS7-Module nicht in Windows PowerShell geladen werden. Der WinPSModulePath Wert wird beim Starten von Windows PowerShell verwendet.

Starten von PowerShell 7 über Windows PowerShell

Der PowerShell 7-Start wird wie folgt fortgesetzt: Es werden pfadvererbte Pfade hinzugefügt, die Von Windows PowerShell hinzugefügt wurden. Da die PS7-spezifischen Pfade präfixiert sind, gibt es kein funktionales Problem.

Modulsuchverhalten

PowerShell durchsucht rekursiv jeden Ordner im PSModulePath nach Moduldateien (.psd1 oder .psm1) Dateien. Dieses Suchmuster ermöglicht die Installation mehrerer Versionen desselben Moduls in verschiedenen Ordnern. Zum Beispiel:

    Directory: C:\Program Files\WindowsPowerShell\Modules\PowerShellGet

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----           8/14/2020  5:56 PM                1.0.0.1
d----           9/13/2019  3:53 PM                2.1.2

Standardmäßig lädt PowerShell die höchste Versionsnummer eines Moduls, wenn mehrere Versionen gefunden werden. Verwenden Sie Import-Module zum Laden einer bestimmten Version den Parameter FullyQualifiedName . Weitere Informationen finden Sie unter Import-Module.

Ändern von PSModulePath

In den meisten Fällen sollten Sie Module an den Standardmodulspeicherorten installieren. Möglicherweise müssen Sie jedoch den Wert der PSModulePath Umgebungsvariable ändern.

Wenn Sie beispielsweise das C:\Program Files\Fabrikam\Modules Verzeichnis $env:PSModulePath für die aktuelle Sitzung vorübergehend hinzufügen möchten, geben Sie Folgendes ein:

$Env:PSModulePath = $Env:PSModulePath+";C:\Program Files\Fabrikam\Modules"

Der Semikolon (;) im Befehl trennt den neuen Pfad vom Pfad, der ihm in der Liste vorausgeht. Auf Nicht-Windows-Plattformen trennt der Doppelpunkt (:) die Pfadspeicherorte in der Umgebungsvariable.

Ändern von PSModulePath in Nicht-Windows

Um den Wert PSModulePath für jede Sitzung in einer Nicht-Windows-Umgebung zu ändern, fügen Sie ihrem PowerShell-Profil den vorherigen Befehl hinzu.

Ändern von PSModulePath in Windows

Um den Wert in PSModulePath jeder Sitzung zu ändern, bearbeiten Sie den Registrierungsschlüssel, der die PSModulePath Werte speichert. Die PSModulePath Werte werden in der Registrierung als nichtexpandierte Zeichenfolgen gespeichert. Um das dauerhafte Speichern der PSModulePath Werte als erweiterte Zeichenfolgen zu vermeiden, verwenden Sie die GetValue-Methode für den Unterschlüssel, und bearbeiten Sie den Wert direkt.

Im folgenden Beispiel wird der C:\Program Files\Fabrikam\Modules Pfad zum Wert der PSModulePath Umgebungsvariablen hinzugefügt, ohne die nicht erweiterten Zeichenfolgen zu erweitern.

$key = (Get-Item 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager').OpenSubKey('Environment', $true)
$path = $key.GetValue('PSModulePath','','DoNotExpandEnvironmentNames')
$path += ';%ProgramFiles%\Fabrikam\Modules'
$key.SetValue('PSModulePath',$path,[Microsoft.Win32.RegistryValueKind]::ExpandString)

Wenn Sie der Benutzereinstellung einen Pfad hinzufügen möchten, ändern Sie den Registrierungsanbieter von HKLM:\ " in " HKCU:\.

$key = (Get-Item 'HKCU:\').OpenSubKey('Environment', $true)
$path = $key.GetValue('PSModulePath','','DoNotExpandEnvironmentNames')
$path += ';%ProgramFiles%\Fabrikam\Modules'
$key.SetValue('PSModulePath',$path,[Microsoft.Win32.RegistryValueKind]::ExpandString)

Weitere Informationen