tentang_PSModulePath

Deskripsi singkat

Artikel ini menjelaskan tujuan dan penggunaan variabel lingkungan $env:PSModulePath.

Deskripsi panjang

Variabel lingkungan $env:PSModulePath berisi daftar lokasi folder yang dicari untuk menemukan modul dan sumber daya. PowerShell secara rekursif mencari setiap folder untuk file modul (.psd1 atau .psm1).

memiliki parameter Cakupan yang memungkinkan Anda menentukan apakah modul diinstal untuk pengguna saat ini atau untuk semua pengguna. Untuk informasi selengkapnya, lihat Install-Module.

Secara default, lokasi efektif yang ditetapkan ke $env:PSModulePath adalah:

Lokasi di seluruh sistem: Folder ini berisi modul yang dikirimkan dengan PowerShell. Modul-modul ini disimpan di $PSHOME\Modules folder.
- Di Windows, modul yang diinstal dalam cakupan AllUsers disimpan di $env:ProgramFiles\WindowsPowerShell\Modules.
- Pada sistem non-Windows, modul yang diinstal dalam cakupan AllUsers disimpan di /usr/local/share/powershell/Modules.
Modul yang diinstal pengguna: Di Windows, modul yang diinstal dalam cakupan CurrentUser biasanya disimpan dalam $HOME\Documents\WindowsPowerShell\Modules folder. Lokasi spesifik folder Documents bervariasi menurut versi Windows dan saat Anda menggunakan pengalihan folder. Selain itu, Microsoft OneDrive dapat mengubah lokasi folder Documents Anda. Anda dapat memverifikasi lokasi folder Anda Documents menggunakan perintah berikut: [Environment]::GetFolderPath('MyDocuments').

Pada sistem non-Windows, modul yang diinstal dalam cakupan CurrentUser disimpan dalam $HOME/.local/share/powershell/Modules folder.
Modul khusus aplikasi: Program pengaturan dapat menginstal modul di direktori lain, seperti Program Files folder di Windows. Paket penginstal mungkin atau mungkin tidak menambahkan lokasi ke .$env:PSModulePath

Konstruksi PowerShell PSModulePath

Nilai $env:PSModulePath dibangun setiap kali PowerShell dimulai. Nilai bervariasi menurut versi PowerShell dan bagaimana diluncurkan.

Startup Windows PowerShell

Windows PowerShell menggunakan logika berikut untuk membuat PSModulePath saat startup:

Jika PSModulePath tidak ada, gabungkan CurrentUser, AllUsers, dan jalur modul $PSHOME
Jika PSModulePath memang ada:
- Jika PSModulePath berisi jalur modul $PSHOME:
  - jalur modul AllUsers dimasukkan sebelum jalur modul $PSHOME
- lain:
  - Cukup gunakan PSModulePath seperti yang didefinisikan karena pengguna sengaja menghapus lokasi $PSHOME

Jalur modul CurrentUser diawali hanya jika cakupan Pengguna $env:PSModulePath tidak ada. Jika tidak, cakupan pengguna $env:PSModulePath digunakan sebagaimana didefinisikan.

Startup PowerShell 7

Di Windows, untuk sebagian besar variabel lingkungan, jika variabel Cakupan pengguna ada, proses baru menggunakan nilai tersebut hanya meskipun variabel cakupan Mesin dengan nama yang sama ada.

Di PowerShell 7, PSModulePath diperlakukan mirip dengan bagaimana Path variabel lingkungan diperlakukan di Windows. Di Windows, Path diperlakukan berbeda dari variabel lingkungan lainnya. Ketika proses dimulai, Windows menggabungkan Path cakupan pengguna dengan Pathcakupan mesin .

Mengambil PSModulePath cakupan pengguna
Bandingkan dengan memproses variabel lingkungan PSModulePath yang diwariskan
- Jika sama:
  - Tambahkan ke akhir setelah semantik variabel lingkungan PSModulePath
  - Jalur Windows System32 berasal dari mesin yang ditentukan PSModulePath sehingga tidak perlu ditambahkan secara eksplisit
- Jika berbeda, perlakukan seolah-olah pengguna secara eksplisit memodifikasinya dan tidak menambahkan AllUsersPSModulePath
Awalan dengan jalur Pengguna, Sistem, dan $PSHOME PS7 dalam urutan tersebut
- Jika powershell.config.json berisi PSModulePathyang dilingkup pengguna , gunakan itu alih-alih default untuk pengguna
- Jika powershell.config.json berisi sistem yang terlingkup PSModulePath, gunakan itu alih-alih default untuk sistem

Sistem Unix tidak memiliki pemisahan variabel lingkungan Pengguna dan Sistem. PSModulePath diwariskan dan jalur khusus PS7 diawali jika belum ditentukan.

Memulai Windows PowerShell dari PowerShell 7

Untuk diskusi ini, Windows PowerShell berarti powershell.exe dan powershell_ise.exe.

Nilai $env:PSModulePath disalin ke WinPSModulePath dengan modifikasi berikut:

Menghapus PS7 jalur modul Pengguna
Menghapus PS7 jalur modul Sistem
Menghapus PS7 jalur modul $PSHOME

Jalur PS7 dihapus sehingga modul PS7 tidak dimuat di Windows PowerShell. Nilai WinPSModulePath digunakan saat memulai Windows PowerShell.

Memulai PowerShell 7 dari Windows PowerShell

Startup PowerShell 7 berlanjut as-is dengan penambahan jalur warisan yang ditambahkan Windows PowerShell. Karena jalur khusus PS7 diawali, tidak ada masalah fungsi.

Perilaku pencarian modul

PowerShell secara rekursif mencari setiap folder di file PSModulePath untuk modul (.psd1 atau .psm1). Pola pencarian ini memungkinkan beberapa versi modul yang sama diinstal di folder yang berbeda. Misalnya:

    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

Secara default, PowerShell memuat nomor versi tertinggi modul saat beberapa versi ditemukan. Untuk memuat versi tertentu, gunakan Import-Module dengan parameter FullyQualifiedName. Untuk informasi selengkapnya, lihat Import-Module .

Memodifikasi PSModulePath

Untuk sebagian besar situasi, Anda harus menginstal modul di lokasi modul default. Namun, Anda mungkin perlu mengubah nilai PSModulePath variabel lingkungan.

Misalnya, untuk menambahkan direktori C:\Program Files\Fabrikam\Modules untuk sementara waktu ke $env:PSModulePath untuk sesi saat ini, ketik:

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

Titik koma (;) dalam perintah memisahkan jalur baru dari jalur yang mendahuluinya dalam daftar. Pada platform non-Windows, titik dua (:) memisahkan lokasi jalur dalam variabel lingkungan.

Memodifikasi PSModulePath di non-Windows

Untuk mengubah nilai PSModulePath untuk setiap sesi di lingkungan non-Windows, tambahkan perintah sebelumnya ke profil PowerShell Anda.

Memodifikasi PSModulePath di Windows

Untuk mengubah nilai PSModulePath di setiap sesi, edit kunci registri yang menyimpan nilai PSModulePath. Nilai PSModulePath disimpan dalam registri sebagai string yang belum ada. Untuk menghindari penyimpanan PSModulePath nilai secara permanen sebagai string yang diperluas , gunakan metode GetValue pada subkunci dan edit nilainya secara langsung.

Contoh berikut menambahkan C:\Program Files\Fabrikam\Modules jalur ke nilai PSModulePath variabel lingkungan tanpa memperluas string yang tidak diperluas.

$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)

Untuk menambahkan jalur ke pengaturan pengguna, ubah penyedia registri dari HKLM:\ menjadi 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)

Lihat juga

tentang_Modul

Last updated on 2023-03-24

Bagikan melalui