about_PSModulePath
Краткое описание
В этой статье описывается назначение и использование переменной $env:PSModulePath
среды.
Подробное описание
Переменная $env:PSModulePath
среды содержит список расположений папок, искомых для поиска модулей и ресурсов. PowerShell рекурсивно ищет каждую папку для файлов модулей (.psd1
или .psm1
) .
Install-Module
имеет параметр Scope, позволяющий указать, установлен ли модуль для текущего пользователя или для всех пользователей. Дополнительные сведения см. в разделе Install-Module.
По умолчанию назначены действующие расположения $env:PSModulePath
:
Расположения на уровне системы: эти папки содержат модули, которые поставляется с помощью PowerShell. Эти модули хранятся в папке
$PSHOME\Modules
. Это также расположение, в котором установлены модули управления Windows.Модули, установленные в область AllUsers, хранятся в
$env:ProgramFiles\WindowsPowerShell\Modules
.Установленные пользователем модули: это модули, установленные в область CurrentUser. Расположение область CurrentUser обычно является папкой
$HOME\Documents\WindowsPowerShell\Modules
. Конкретное расположениеDocuments
папки зависит от версии Windows и при использовании перенаправления папок. Кроме того, Microsoft OneDrive может изменить расположение папкиDocuments
. Вы можете проверить расположение папки с помощью следующейDocuments
команды.[Environment]::GetFolderPath('MyDocuments')
Определенные модули приложения: программы установки могут устанавливать модули в других каталогах, например
Program Files
каталог. Установщик может добавить расположение приложения к значению$env:PSModulePath
.
Построение PowerShell PSModulePath
Значение $env:PSModulePath
создается при каждом запуске PowerShell.
Значение зависит от версии PowerShell и способа ее запуска.
Запуск Windows PowerShell
Windows PowerShell использует следующую логику для создания PSModulePath
при запуске:
- Если
PSModulePath
не существует, объедините CurrentUser, AllUsers и$PSHOME
пути модулей - Если
PSModulePath
существует:- Если
PSModulePath
содержится путь к модулям$PSHOME
:- Путь к модулям AllUsers вставляется перед
$PSHOME
путем модулей
- Путь к модулям AllUsers вставляется перед
- Еще:
- Просто используйте
PSModulePath
как определено, так как пользователь намеренно удалил$PSHOME
расположение
- Просто используйте
- Если
Путь модуля CurrentUser префиксируется только в том случае, если пользователь область $env:PSModulePath
не существует. В противном случае пользователь область $env:PSModulePath
используется как определено.
Поведение поиска модуля
PowerShell рекурсивно выполняет поиск каждой папки в файлах PSModulePath для модулей (.psd1
или .psm1
) . Этот шаблон поиска позволяет устанавливать несколько версий одного модуля в разных папках. Например:
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
По умолчанию PowerShell загружает наибольшее число версий модуля при обнаружении нескольких версий. Чтобы загрузить определенную версию, используйте Import-Module
параметр ПолностьюQualifiedName . Дополнительные сведения см. в разделе Import-Module.
Изменение PSModulePath
В большинстве случаев следует устанавливать модули в расположениях модулей по умолчанию. Однако может потребоваться изменить значение переменной PSModulePath
среды.
Например, чтобы временно добавить каталог $env:PSModulePath
в текущий C:\Program Files\Fabrikam\Modules
сеанс, введите:
$Env:PSModulePath = $Env:PSModulePath+";C:\Program Files\Fabrikam\Modules"
Чтобы изменить значение каждого сеанса PSModulePath
, измените раздел реестра, в котором хранятся PSModulePath
значения. Значения PSModulePath
хранятся в реестре как необъяснимые строки. Чтобы избежать постоянного сохранения PSModulePath
значений в виде развернутых строк, используйте метод GetValue в подразделе и измените значение напрямую.
В следующем примере путь добавляется C:\Program Files\Fabrikam\Modules
к значению переменной PSModulePath
среды без расширения не развернутых строк.
$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)
Чтобы добавить путь к параметру пользователя, измените поставщика реестра на HKLM:\
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)
См. также
PowerShell