about_PSModulePath
Zmienna $env:PSModulePath
środowiskowa zawiera listę lokalizacji folderów, które są przeszukiwane w celu znalezienia modułów i zasobów. Program PowerShell cyklicznie wyszukuje każdy folder dla plików modułu (.psd1
lub .psm1
).
Domyślnie obowiązujące lokalizacje przypisane do $env:PSModulePath
:
Lokalizacje dla całego systemu: te foldery zawierają moduły dostarczane za pomocą programu PowerShell. Te moduły są przechowywane w folderze
$PSHOME\Modules
. Jest to również lokalizacja, w której są instalowane moduły zarządzania systemem Windows.Moduły zainstalowane przez użytkownika: są to moduły zainstalowane przez użytkownika.
Install-Module
Ma parametr Zakres , który umożliwia określenie, czy moduł jest zainstalowany dla bieżącego użytkownika, czy dla wszystkich użytkowników. Aby uzyskać więcej informacji, zobacz Install-Module (Instalowanie modułu).- W systemie Windows lokalizacja zakresu CurrentUser specyficznego dla użytkownika jest folderem
$HOME\Documents\PowerShell\Modules
. Lokalizacja zakresu AllUsers to$env:ProgramFiles\PowerShell\Modules
. - W systemach innych niż Windows lokalizacja zakresu CurrentUser specyficznego dla użytkownika jest folderem
$HOME/.local/share/powershell/Modules
. Lokalizacja zakresu AllUsers to/usr/local/share/powershell/Modules
.
- W systemie Windows lokalizacja zakresu CurrentUser specyficznego dla użytkownika jest folderem
Ponadto programy instalacyjne, które instalują moduły w innych katalogach, takich jak katalog Program Files, mogą dołączać ich lokalizacje do wartości $env:PSModulePath
.
Uwaga
W systemie Windows lokalizacja specyficzna dla użytkownika to PowerShell\Modules
folder znajdujący się w folderze Dokumenty w profilu użytkownika. Określona ścieżka tej lokalizacji różni się w zależności od wersji systemu Windows i tego, czy używasz przekierowania folderów. Usługa Microsoft OneDrive może również zmienić lokalizację folderu Dokumenty . Lokalizację folderu Documents można sprawdzić za pomocą następującego polecenia: [Environment]::GetFolderPath('MyDocuments')
.
Konstrukcja programu PowerShell PSModulePath
Wartość jest tworzona przy każdym uruchomieniu $env:PSModulePath
programu PowerShell.
Wartość różni się w zależności od wersji programu PowerShell i sposobu jej uruchamiania.
uruchamianie Windows PowerShell
Windows PowerShell używa następującej logiki do konstruowania przy uruchamianiuPSModulePath
:
- Jeśli
PSModulePath
nie istnieje, połącz ścieżki CurrentUser, AllUsers i$PSHOME
modules - Jeśli
PSModulePath
istnieje:- Jeśli
PSModulePath
zawiera$PSHOME
ścieżkę modułów:- Ścieżka modułów AllUsers jest wstawiana przed
$PSHOME
ścieżką modułów
- Ścieżka modułów AllUsers jest wstawiana przed
- Innego:
- Po prostu użyj polecenia zgodnie z
PSModulePath
definicją, ponieważ użytkownik celowo usunął lokalizację$PSHOME
- Po prostu użyj polecenia zgodnie z
- Jeśli
Ścieżka modułu CurrentUser jest poprzedzona prefiksem tylko wtedy, gdy zakres $env:PSModulePath
użytkownika nie istnieje. W przeciwnym razie zakres $env:PSModulePath
użytkownika jest używany zgodnie z definicją.
Uruchamianie programu PowerShell 7
W systemie Windows w przypadku większości zmiennych środowiskowych, jeśli istnieje zmienna o zakresie użytkownika, nowy proces używa tej wartości tylko wtedy, gdy istnieje zmienna o zakresie maszyny o tej samej nazwie.
W programie PowerShell 7 PSModulePath
jest traktowany podobnie jak zmienna Path
środowiskowa jest traktowana w systemie Windows. W systemie Windows Path
jest traktowany inaczej niż inne zmienne środowiskowe. Po uruchomieniu procesu system Windows łączy zakres użytkownika Path
z zakresem Maszyny Path
.
- Pobieranie zakresu użytkownika
PSModulePath
- Porównanie z dziedziczonej
PSModulePath
zmiennej środowiskowej- Jeśli to samo:
- Dołącz wartość AllUsers
PSModulePath
na końcu po semantyce zmiennej środowiskowejPath
- Ścieżka systemu Windows
System32
pochodzi ze zdefiniowanejPSModulePath
maszyny, więc nie trzeba ich jawnie dodawać
- Dołącz wartość AllUsers
- Jeśli jest inaczej, traktuj to tak, jakby użytkownik jawnie go zmodyfikował i nie dołączaj użytkowników AllUsers
PSModulePath
- Jeśli to samo:
- Prefiks z ps7 użytkownik, system i
$PSHOME
ścieżki w tej kolejności- Jeśli
powershell.config.json
zawiera użytkownika oPSModulePath
zakresie , użyj tego zamiast wartości domyślnej dla użytkownika - Jeśli
powershell.config.json
zawiera system oPSModulePath
zakresie , użyj tego zamiast wartości domyślnej dla systemu
- Jeśli
Systemy Unix nie mają separacji zmiennych środowiskowych użytkownika i systemu.
PSModulePath
jest dziedziczony, a ścieżki specyficzne dla ps7 są poprzedzone prefiksem, jeśli nie zostały jeszcze zdefiniowane.
Uruchamianie Windows PowerShell z programu PowerShell 7
Na potrzeby tej dyskusji Windows PowerShell oznacza zarówno , jak powershell.exe
i powershell_ise.exe
.
Wartość $env:PSModulePath
jest kopiowana do WinPSModulePath
elementu z następującymi modyfikacjami:
- Usuwanie ps7 ścieżki modułu User
- Usuwanie ścieżki modułu systemowego PS7
- Usuwanie ścieżki modułu
$PSHOME
ps7
Ścieżki PS7 są usuwane, aby moduły PS7 nie zostały załadowane w Windows PowerShell. Wartość jest używana podczas uruchamiania WinPSModulePath
Windows PowerShell.
Uruchamianie programu PowerShell 7 z Windows PowerShell
Uruchamianie programu PowerShell 7 jest kontynuowane w miarę dodawania dziedziczących ścieżek, które Windows PowerShell dodane. Ponieważ ścieżki specyficzne dla programu PS7 są poprzedzone prefiksem, nie ma problemu z funkcjonalnością.
Zachowanie wyszukiwania modułów
Program PowerShell cyklicznie przeszukuje każdy folder w pliku PSModulePath dla plików modułu (.psd1
lub .psm1
). Ten wzorzec wyszukiwania umożliwia zainstalowanie wielu wersji tego samego modułu w różnych folderach. Na przykład:
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
Domyślnie program PowerShell ładuje najwyższy numer wersji modułu po znalezieniu wielu wersji. Aby załadować określoną wersję, użyj parametru Import-Module
FullyQualifiedName . Aby uzyskać więcej informacji, zobacz Import-Module.
Modyfikowanie elementu PSModulePath
W większości sytuacji należy zainstalować moduły w domyślnych lokalizacjach modułów. Może być jednak konieczne zmianę wartości zmiennej środowiskowej PSModulePath
.
Aby na przykład tymczasowo dodać C:\Program Files\Fabrikam\Modules
katalog do $env:PSModulePath
bieżącej sesji, wpisz:
$Env:PSModulePath = $Env:PSModulePath+";C:\Program Files\Fabrikam\Modules"
Średnik (;
) w poleceniu oddziela nową ścieżkę od ścieżki, która poprzedza ją na liście. Na platformach innych niż Windows dwukropek (:
) oddziela lokalizacje ścieżek w zmiennej środowiskowej.
Modyfikowanie ścieżki PSModulePath w systemach innych niż Windows
Aby zmienić wartość PSModulePath
dla każdej sesji w środowisku spoza systemu Windows, dodaj poprzednie polecenie do profilu programu PowerShell.
Modyfikowanie ścieżki PSModulePath w systemie Windows
Aby zmienić wartość PSModulePath
dla każdej sesji w środowisku systemu Windows, zmodyfikuj klucz rejestru przechowując PSModulePath
wartości. Wartości PSModulePath
są przechowywane w rejestrze jako nieokreślone ciągi. Aby uniknąć trwałego zapisywania PSModulePath
wartości jako rozszerzonych ciągów, użyj metody GetValue w kluczu podrzędnym i zmodyfikuj wartość bezpośrednio.
Poniższy przykład dodaje ścieżkę C:\Program Files\Fabrikam\Modules
do wartości PSModulePath
zmiennej środowiskowej bez rozszerzania ciągów bez rozszerzania.
$key = (Get-Item 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager').OpenSubKey('Environment', $true)
$path = $key.GetValue('PSModulePath','','DoNotExpandEnvironmentNames')
$path += ';C:\Program Files\Fabrikam\Modules' # or '%ProgramFiles%\Fabrikam\Modules'
$key.SetValue('PSModulePath',$path,[Microsoft.Win32.RegistryValueKind]::ExpandString)
Aby dodać ścieżkę do ustawienia użytkownika, zmień dostawcę rejestru z HKLM:\
na HKCU:\
.
$key = (Get-Item 'HKCU:\SYSTEM\CurrentControlSet\Control\Session Manager').OpenSubKey('Environment', $true)
$path = $key.GetValue('PSModulePath','','DoNotExpandEnvironmentNames')
$path += ';C:\Program Files\Fabrikam\Modules' # or '%ProgramFiles%\Fabrikam\Modules'
$key.SetValue('PSModulePath',$path,[Microsoft.Win32.RegistryValueKind]::ExpandString)