about_PSModulePath

Makale
2025-02-05

Kısa açıklama

Bu makalede ortam değişkeninin amacı ve kullanımı $Env:PSModulePath açıklanmaktadır.

Uzun açıklama

$Env:PSModulePath ortam değişkeni, klasör konumlarının listesini içerir. PowerShell, her klasörde modül (.psd1 veya .psm1) dosyalarını özyinelemeli olarak arar.

Varsayılan olarak, atanan $Env:PSModulePath geçerli konumlar şunlardır:

CurrentUser kapsamında yüklü modüller:
- Windows'da bu modüller $HOME\Documents\PowerShell\Modulesiçinde depolanır. Klasörün belirli konumu Documents Windows sürümüne ve klasör yeniden yönlendirme kullandığınızda değişir. Ayrıca, Microsoft OneDrive klasörünüzün Documents konumunu değiştirebilir. Documents klasörünüzün konumunu doğrulamak için şu komutu kullanın: [Environment]::GetFolderPath('MyDocuments').
- Windows olmayan sistemlerde bu modüller $HOME/.local/share/powershell/Modules klasöründe depolanır.
AllUsers kapsamında yüklü modüller:
- Windows'da bu modüller $Env:ProgramFiles\PowerShell\Modulesiçinde depolanır.
- Windows olmayan sistemlerde, bu modüller /usr/local/share/powershell/Modulesiçinde depolanır.
PowerShell ile birlikte gelen modüller $PSHOME\Modulesiçinde depolanır.

Not

PowerShell modülleri içeren uygulamalar, Program Files klasörü gibi Windows'daki diğer dizinlere modül yükleyebilir. Yükleyici paketi konumu $Env:PSModulePatheklemeyebilir.

Windows PowerShell 5.1 için varsayılan konumlar PowerShell 7'den farklıdır.

CurrentUser kapsamına yüklenen modüller $HOME\Documents\WindowsPowerShell\Modulesiçinde depolanır.
AllUsers kapsamına yüklenen modüller $Env:ProgramFiles\WindowsPowerShell\Modulesiçinde depolanır.
$PSHOME\Modules $Env:SystemRoot\System32\WindowsPowerShell\1.0\Modulesiçinde depolanan Windows PowerShell ile birlikte gelen modüller.

PowerShell PSModulePath yapısı

değeri $Env:PSModulePath , PowerShell her başlatıldığında oluşturulur. Değer, PowerShell sürümüne ve nasıl başlattığınıza göre değişir.

Windows PowerShell başlatma

Windows PowerShell, başlangıçta oluşturmak PSModulePath için aşağıdaki mantığı kullanır:

Yoksa PSModulePath CurrentUser, AllUsers ve modül yollarını birleştirin $PSHOME
Varsa PSModulePath :
- Modüller yolu içeriyorsa PSModulePath$PSHOME :
  - AllUsers modül yolu modül yolundan önce $PSHOME eklenir
- başka:
  - Kullanıcı konumu kasıtlı olarak kaldırdığındanPSModulePath, yalnızca tanımlandığı gibi kullanın $PSHOME

CurrentUser modül yolu, yalnızca Kullanıcı kapsamı $Env:PSModulePath yoksa önek olarak eklenir. Aksi takdirde, Kullanıcı kapsamı $Env:PSModulePath tanımlandığı gibi kullanılır.

PowerShell 7 başlatma

Windows'da çoğu ortam değişkeni için Kullanıcı kapsamlı değişken varsa, aynı ada sahip Makine kapsamlı bir değişken mevcut olsa bile yeni bir işlem yalnızca bu değeri kullanır. Ortam değişkenleri yolu farklı değerlendirilir.

Windows'da PSModulePath, Path ortam değişkeninin nasıl işlendiğinden benzer şekilde ele alır. Path diğer ortam değişkenlerinden farklı şekilde ele alınıyor. Bir işlem başlatıldığında, Windows Kullanıcı kapsamlı Path ile Makine kapsamlı Pathöğesini birleştirir.

Kullanıcı Kapsamlı'nı alma PSModulePath
Devralınan ortam değişkenlerini PSModulePath işlemekle karşılaştır
- Aynıysa:
  - Ortam değişkeninin semantiğinin ardından AllUsers'ıPSModulePathPATH sonuna ekleyin
  - Windows System32 yolu makine tanımlı PSModulePath geldiğinden açıkça eklenmesi gerekmez
- Farklıysa, kullanıcı açıkça değiştirmiş gibi davranın ve AllUsers'ı eklemeyin PSModulePath
PS7 Kullanıcı, Sistem ve $PSHOME yollara bu sırayla sahip ön ek
- Kapsamı powershell.config.jsonbelirlenmiş bir kullanıcı içeriyorsaPSModulePath, kullanıcı için varsayılan yerine bunu kullanın
- powershell.config.json kapsamlı PSModulePathbir sistem içeriyorsa, sistem için varsayılan yerine bunu kullanın

Windows dışı sistemlerde Kullanıcı ve Sistem ortam değişkenlerinin ayrımı yoktur. PSModulePath devralınır ve önceden tanımlanmamışsa PS7'ye özgü yollar önek olarak eklenir.

Windows PowerShell'i PowerShell 7'den başlatma

Bu tartışma için Windows PowerShell hem hem de powershell.exepowershell_ise.exeanlamına gelir.

değeri $Env:PSModulePath aşağıdaki değişikliklerle kopyalanır WinPSModulePath :

PS7 kullanıcı modülü yolunu kaldırma
PS7'yi Sistem modülü yolunu kaldırma
PS7'yi $PSHOME modül yolunu kaldırma

PS7 modüllerinin Windows PowerShell'de yüklenmemesi için PS7 yolları kaldırılır. Değeri WinPSModulePath , Windows PowerShell başlatılırken kullanılır.

PowerShell 7'ye Windows PowerShell'den başlama

PowerShell 7 başlatma işlemi, Windows PowerShell'in eklediği devralan yolların eklenmesiyle olduğu gibi devam eder. PS7'ye özgü yollar ön ekli olduğundan işlevsel bir sorun yoktur.

Modül arama davranışı

PowerShell, MODÜL ( veya .psd1) dosyaları için PSModulePath'teki .psm1 her klasörü özyinelemeli olarak arar. Bu arama düzeni, aynı modülün birden çok sürümünün farklı klasörlere yüklenmesini sağlar. Örneğin:

    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

Varsayılan olarak PowerShell, birden çok sürüm bulunduğunda modülün en yüksek sürüm numarasını yükler. Belirli bir sürümü yüklemek için FullyQualifiedName parametresiyle kullanın.Import-Module Daha fazla bilgi için bkz . Import-Module.

PSModulePath'i Değiştirme

Çoğu durumda modülleri varsayılan modül konumlarına yüklemeniz gerekir. Ancak, PSModulePath ortam değişkeninin değerini değiştirmeniz gerekebilir.

Örneğin, geçerli oturumun dizinini C:\Program Files\Fabrikam\Modules$Env:PSModulePath geçici olarak eklemek için şunu yazın:

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

Komuttaki noktalı virgül (;), yeni yolu listede kendisinden önceki yoldan ayırır. Windows olmayan platformlarda iki nokta üst üste (:), ortam değişkenindeki yol konumlarını ayırır.

Windows olmayan bir uygulamada PSModulePath'i değiştirme

Windows dışı bir ortamdaki her oturumun PSModulePath değerini değiştirmek için önceki komutu PowerShell profilinize ekleyin.

Windows'da PSModulePath'i değiştirme

Değerini her oturumda değiştirmek PSModulePath için, değerleri depolayarak PSModulePath kayıt defteri anahtarını düzenleyin. PSModulePath Değerler kayıt defterinde genişletilmemiş dizeler olarak depolanır. genişletilmiş dizeleri olarak PSModulePath değerlerini kalıcı olarak kaydetmekten kaçınmak için alt anahtardaki GetValue() yöntemini kullanın ve değeri doğrudan düzenleyin.

Aşağıdaki örnek, C:\Program Files\Fabrikam\Modules yolunu genişletilmemiş dizeleri genişletmeden PSModulePath ortam değişkeninin değerine ekler.

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

Kullanıcı ayarına yol eklemek için aşağıdaki kodu kullanın:

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

Aracılığıyla paylaş