about_PSModulePath

Статья
08/03/2024

Переменная среды $env:PSModulePath содержит список расположений папок, искомых для поиска модулей и ресурсов. PowerShell рекурсивно выполняет поиск каждой папки для файлов модуля (.psd1 или .psm1).

По умолчанию действующие расположения, назначенные $env:PSModulePath:

Расположения на уровне системы: эти папки содержат модули, которые поставляется с помощью PowerShell. Эти модули хранятся в папке $PSHOME\Modules. Это также расположение, в котором установлены модули управления Windows.
Установленные пользователем модули: это модули, установленные пользователем. имеет параметр области , позволяющий указать, установлен ли модуль для текущего пользователя или для всех пользователей. Дополнительные сведения см. в разделе Install-Module.
- В Windows расположение CurrentUser пользователя — это папка $HOME\Documents\PowerShell\Modules. Расположение области AllUsers — .
- В системах, отличных от Windows, расположение области CurrentUser пользователя — это папка $HOME/.local/share/powershell/Modules. Расположение области AllUsers — .

Кроме того, программы установки, устанавливающие модули в других каталогах, например каталог Program Files, могут добавлять их расположения в значение $env:PSModulePath.

Заметка

В Windows конкретное расположение — это папка , расположенная в папке документов в профиле пользователя. Конкретный путь к расположению зависит от версии Windows и используется ли вы перенаправление папок. Microsoft OneDrive также может изменить расположение папки Documents. Вы можете проверить расположение папки документов с помощью следующей команды: .

Построение PowerShell PSModulePath

Значение $env:PSModulePath создается при каждом запуске PowerShell. Значение зависит от версии PowerShell и способа ее запуска.

Запуск Windows PowerShell

Windows PowerShell использует следующую логику для создания PSModulePath при запуске:

Если PSModulePath не существует, объедините CurrentUser, AllUsersи пути модулей $PSHOME
Если PSModulePath существует:
- Если PSModulePath содержит путь $PSHOME модулей:
  - Путь к модулям allUsers вставлен до пути $PSHOME модулей
- еще:
  - Просто используйте PSModulePath, как определено, так как пользователь намеренно удалил расположение $PSHOME

Путь модуля CurrentUser префиксируется только в том случае, если область пользователя $env:PSModulePath не существует. В противном случае область пользователя $env:PSModulePath используется в соответствии с определенными параметрами.

Запуск PowerShell 7

В Windows для большинства переменных среды, если переменная, ограниченная пользователем, существует, новый процесс использует это значение только в том случае, если переменная с областью компьютера имеет то же имя.

В PowerShell 7 PSModulePath обрабатывается аналогично тому, как переменная среды Path обрабатывается в Windows. В Windows Path обрабатывается по-другому от других переменных среды. При запуске процесса Windows объединяет Path с Pathс областью действия компьютера.

Получение PSModulePath с областью действия пользователя
Сравнение с наследуемой PSModulePath переменной среды
- Если то же самое:
  - Добавьте AllUsersPSModulePath в конец после семантики переменной среды Path
  - Путь System32 Windows поступает с компьютера, определенного PSModulePath, поэтому не требуется явно добавлять
- Если он отличается, обработайте его явным образом и не добавляйте AllUsersPSModulePath
Префикс с путями пользователя, системы и $PSHOME PS7 в этом порядке
- Если powershell.config.json содержит PSModulePathпользователя, используйте его вместо значения по умолчанию для пользователя.
- Если powershell.config.json содержит системный PSModulePath, используйте его вместо значения по умолчанию для системы.

Системы Unix не имеют разделения переменных среды пользователя и системы. PSModulePath наследуется, и путь, зависящий от PS7, префиксируется, если он еще не определен.

Запуск Windows PowerShell из PowerShell 7

Для этого обсуждения Windows PowerShell означает как powershell.exe, так и powershell_ise.exe.

Значение $env:PSModulePath копируется в WinPSModulePath со следующими изменениями:

Удаление путь к модулю PS7
Удаление PS7 пути к системным модулям
Удаление PS7 пути модуля $PSHOME

Пути PS7 удаляются, чтобы модули PS7 не загружались в Windows PowerShell. Значение WinPSModulePath используется при запуске Windows PowerShell.

Запуск PowerShell 7 из Windows PowerShell

Запуск PowerShell 7 продолжает as-is с добавлением наследуемых путей, добавленных Windows PowerShell. Так как пути, относящиеся к PS7, префиксируются, функциональные проблемы отсутствуют.

Поведение поиска модуля

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 с параметром FullyQualifiedName. Дополнительные сведения см. в разделе Import-Module.

Изменение PSModulePath

В большинстве случаев следует устанавливать модули в расположениях модулей по умолчанию. Однако может потребоваться изменить значение переменной среды PSModulePath.

Например, чтобы временно добавить каталог C:\Program Files\Fabrikam\Modules в $env:PSModulePath текущего сеанса, введите следующее:

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

Точка с запятой (;) в команде отделяет новый путь от пути, который предшествует ему в списке. На платформах, отличных от Windows, двоеточие (:) отделяет расположения пути в переменной среды.

Изменение PSModulePath в windows

Чтобы изменить значение PSModulePath для каждого сеанса в среде, отличной от Windows, добавьте предыдущую команду в профиль PowerShell.

Изменение PSModulePath в Windows

Чтобы изменить значение PSModulePath для каждого сеанса в среде Windows, измените раздел реестра, в котором хранятся значения 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 += ';C:\Program Files\Fabrikam\Modules' # or '%ProgramFiles%\Fabrikam\Modules'
$key.SetValue('PSModulePath',$path,[Microsoft.Win32.RegistryValueKind]::ExpandString)

Чтобы добавить путь к параметру пользователя, измените поставщика реестра с HKLM:\ на 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)

См. также

about_Modules
методов среды

Поделиться через