Install-Module
Bir depodan bir veya daha fazla modül indirir ve bunları yerel bilgisayara yükler.
Syntax
Install-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
[-Credential <PSCredential>]
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllowClobber]
[-SkipPublisherCheck]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Install-Module
[-InputObject] <PSObject[]>
[-Credential <PSCredential>]
[-Scope <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-AllowClobber]
[-SkipPublisherCheck]
[-Force]
[-AcceptLicense]
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Cmdlet, Install-Module
çevrimiçi bir depodan belirtilen ölçütleri karşılayan bir veya daha fazla modül alır. Cmdlet, arama sonuçlarının geçerli modüller olduğunu doğrular ve modül klasörlerini yükleme konumuna kopyalar. Yüklenen modüller yüklemeden sonra otomatik olarak içeri aktarılamaz.
Belirtilen modüllerin en düşük, en yüksek ve tam sürümlerine göre hangi modülün yüklendiğini filtreleyebilirsiniz.
Bu, Microsoft.PowerShell.PSResourceGet içindeki cmdlet için Get-InstalledPSResource
bir proxy cmdlet'idir. Daha fazla bilgi için bkz . Install-PSResource.
Örnekler
Örnek 1: Modül bulma ve yükleme
Bu örnek, depodaki bir modülü bulur ve modülü yükler.
Find-Module -Name PowerShellGet | Install-Module
, Find-Module
PowerShellGet modülünü belirtmek için Name parametresini kullanır. Varsayılan olarak, modülün en yeni sürümü depodan indirilir. nesnesi işlem hattına cmdlet'ine Install-Module
gönderilir. Install-Module
içindeki tüm kullanıcılar $env:ProgramFiles\PowerShell\Modules
için modülü yükler.
Örnek 2: Modülü ada göre yükleme
Bu örnekte, PowerShellGet modülünün en yeni sürümü yüklenir.
Install-Module -Name PowerShellGet
, Install-Module
PowerShellGet modülünü belirtmek için Name parametresini kullanır. Varsayılan olarak, modülün en yeni sürümü depodan indirilir ve yüklenir.
Örnek 3: En düşük sürümünü kullanarak modül yükleme
Bu örnekte, PowerShellGet modülünün en düşük sürümü yüklüdür. MinimumVersion parametresi, modülün yüklenmesi gereken en düşük sürümünü belirtir. Modülün daha yeni bir sürümü varsa, bu sürüm tüm kullanıcılar için indirilir ve yüklenir.
Install-Module -Name PowerShellGet -MinimumVersion 2.0.1
, Install-Module
PowerShellGet modülünü belirtmek için Name parametresini kullanır. MinimumVersion parametresi, 2.0.1 sürümünün depodan indirildiğini ve yüklendiğini belirtir. Sürüm 2.0.4 kullanılabilir olduğundan, bu sürüm tüm kullanıcılar için indirilir ve yüklenir.
Örnek 4: Modülün belirli bir sürümünü yükleme
Bu örnekte , PowerShellGet modülünün belirli bir sürümü yüklenir.
Install-Module -Name PowerShellGet -RequiredVersion 2.0.0
, Install-Module
PowerShellGet modülünü belirtmek için Name parametresini kullanır. RequiredVersion parametresi, 2.0.0 sürümünün tüm kullanıcılar için indirildiğini ve yüklendiğini belirtir.
Örnek 5: Modülü yalnızca geçerli kullanıcı için yükleme
Bu örnek, modülün yalnızca geçerli kullanıcı için en yeni sürümünü indirir ve yükler.
Install-Module -Name PowerShellGet -Scope CurrentUser
, Install-Module
PowerShellGet modülünü belirtmek için Name parametresini kullanır.
Install-Module
, PowerShellGet'in en yeni sürümünü indirip geçerli kullanıcının dizinine $HOME\Documents\PowerShell\Modules
yükler.
Örnek 6: Modülün en son yayın öncesi sürümünü yükleme
Bu örnekte, bu sürüm yayın öncesi sürüm olduğunda modülün en son sürümünün nasıl yükleneceği gösterilmektedir. Ön sürüm sürümünü yüklemek için AllowPrerelease parametresi gerekir.
Install-Module -Name Microsoft.PowerShell.Crescendo -AllowPrerelease
Bu yöntemi kullanarak en son sürümü kullanabilirsiniz. En son sürüm ön sürüm değilse modülün en son kararlı sürümünü alırsınız.
Örnek 7: Modülün belirli bir yayın öncesi sürümünü yükleme
Bu örnekte, modülün belirli bir yayın öncesi sürümünün nasıl yükleneceği gösterilmektedir. Cmdlet, Find-Module
PowerShell Galerisi modüllerin yayın öncesi sürümlerini bulmak için kullanılabilir.
Yayın öncesi sürümler biçimindedir <version_number>-<prerelease_label>
.
Find-Module PSReadLine -AllVersions -AllowPrerelease | Select-Object -First 5
Version Name Repository Description
------- ---- ---------- -----------
2.2.6 PSReadLine PSGallery Great command line editing in the PowerS…
2.2.5 PSReadLine PSGallery Great command line editing in the PowerS…
2.2.4-beta1 PSReadLine PSGallery Great command line editing in the PowerS…
2.2.3 PSReadLine PSGallery Great command line editing in the PowerS…
2.2.2 PSReadLine PSGallery Great command line editing in the PowerS…
Install-Module -Name PSReadLine -RequiredVersion 2.2.4-beta1 -AllowPrerelease
RequiredVersion parametresinin değeri için PowerShell Galerisi gösterilen sürümü kullanın.
Parametreler
-AcceptLicense
Lisans gerektiren modüller için AcceptLicense , yükleme sırasında lisans sözleşmesini otomatik olarak kabul eder. Daha fazla bilgi için bkz. Lisans Kabulü Gerektiren Modüller.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowClobber
Bir bilgisayardaki mevcut komutlarla ilgili yükleme çakışmalarıyla ilgili uyarı iletilerini geçersiz kılar.
Bir modül tarafından yüklenen komutlar ile aynı ada sahip mevcut komutların üzerine yazar.
AllowClobber ve Force bir Install-Module
komutta birlikte kullanılabilir.
Proxy cmdlet'i bu parametrenin değerini cmdlet'in NoClobber parametresine Install-PSResource
dönüştürür.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllowPrerelease
Yayın öncesi olarak işaretlenmiş bir modülü yüklemenize olanak tanır.
Proxy cmdlet'i bu parametreyi ön sürüm parametresiyle eşler Install-PSResource
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Cmdlet'i çalıştırmadan Install-Module
önce sizden onay ister.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Belirtilen paket sağlayıcısı veya kaynağı için modül yükleme haklarına sahip bir kullanıcı hesabı belirtir.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
proxy cmdlet'i tarafından Install-PSResource
desteklenmediğinden bu parametreyi yoksayar.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
İşlem hattı girişi için kullanılır. Doğrudan InputObject'e bir değer sağlandığında hata oluşur. InputObject parametresiyle nesneleri geçirmek için işlem hattını kullanın.
Type: | PSObject[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaximumVersion
Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleInstall-PSResource
kullanılacak bir NuGet sürüm arama dizesi oluşturur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MinimumVersion
Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleInstall-PSResource
kullanılacak bir NuGet sürüm arama dizesi oluşturur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Çevrimiçi galeriden yüklenecek modüllerin tam adlarını belirtir. Modül adlarının virgülle ayrılmış listesi kabul edilir. Modül adı, depodaki modül adıyla eşleşmelidir. Modül adlarının listesini almak için kullanın Find-Module
.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PassThru
PassThru parametresini kullanırken, Install-Module
modül için bir PSRepositoryItemInfo nesnesi çıkarır. Bu, cmdlet'ten edindiğiniz bilgilerle Find-Module
aynıdır.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Proxy
proxy cmdlet'i tarafından Install-PSResource
desteklenmediğinden bu parametreyi yoksayar.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
proxy cmdlet'i tarafından Install-PSResource
desteklenmediğinden bu parametreyi yoksayar.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Repository
Modülün indirilip yükleneceği deponun adını belirtmek için Repository parametresini kullanın. Birden çok depo kaydedildiğinde kullanılır. komutunda kayıtlı bir deponun Install-Module
adını belirtir. Depo kaydetmek için kullanın Register-PSRepository
.
Kayıtlı depoları görüntülemek için kullanın Get-PSRepository
.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredVersion
Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleInstall-PSResource
kullanılacak bir NuGet sürüm arama dizesi oluşturur.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scope
Modülün yükleme kapsamını belirtir. Bu parametre için kabul edilebilir değerler AllUsers ve CurrentUser'dır.
AllUsers kapsamı, modülleri bilgisayarın tüm kullanıcıları tarafından erişilebilen bir konuma yükler:
$env:ProgramFiles\PowerShell\Modules
CurrentUser, modülleri yalnızca bilgisayarın geçerli kullanıcısı tarafından erişilebilen bir konuma yükler. Örneğin:
$HOME\Documents\PowerShell\Modules
Hiçbir Kapsam tanımlanmadığında, varsayılan değer PowerShellGet sürümüne göre ayarlanır.
- PowerShellGet 1.x sürümlerinde varsayılan değer, yükleme için yükseltme gerektiren AllUsers'dır.
- PowerShell 6 veya sonraki sürümlerde PowerShellGet 2.0.0 ve üzeri sürümler için:
- Varsayılan değer CurrentUser'dır ve yükleme için yükseltme gerektirmez.
- Yükseltilmiş bir oturumda çalıştırıyorsanız varsayılan değer AllUsers'tır.
Type: | String |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipPublisherCheck
Ara sunucu cmdlet'i çağrıdan Install-PSResource
önce bu parametreyi AthenticodeCheck olarak dönüştürür.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Bir Install-Module
komut çalıştırıldığında ne olacağını gösterir. Cmdlet çalıştırılmıyor.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
PSRepositoryItemInfo
Find-Module
, işlem hattından Install-Module
adresine gönderilebilen PSRepositoryItemInfo nesneleri oluşturur.
String[]
PSObject[]
Çıkışlar
Microsoft.PowerShell.Commands.PSRepositoryItemInfo
PassThru parametresini kullanırken, Install-Module
modül için bir PSRepositoryItemInfo nesnesi çıkarır. Bu, cmdlet'ten edindiğiniz bilgilerle Find-Module
aynıdır.
Notlar
PowerShell, için Install-Module
aşağıdaki diğer adları içerir:
- Tüm platformlar:
inmo
Install-Module
, Windows 7 veya Windows 2008 R2 ve sonraki Windows sürümlerinde PowerShell 5.0 veya sonraki sürümlerde çalışır.
Önemli
Nisan 2020 itibarıyla PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmıyorsanız, PowerShell Galerisi erişmeye çalışırken bir hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Daha fazla bilgi için PowerShell blogundaki duyuruya bakın.
En iyi güvenlik uygulaması olarak, cmdlet'leri veya işlevleri ilk kez çalıştırmadan önce modülün kodunu değerlendirin. Kötü amaçlı kod içeren modüllerin çalışmasını önlemek için, yüklenen modüller yüklemeden sonra otomatik olarak içeri aktarılamaz.
Ad parametresi tarafından belirtilen modül adı depoda yoksa bir Install-Module
hata döndürür.
Birden çok modül yüklemek için Name parametresini kullanın ve virgülle ayrılmış modül adları dizisi belirtin. Birden çok modül adı belirtirseniz MinimumVersion, MaximumVersion veya RequiredVersion kullanamazsınız. Find-Module
, işlem hattından Install-Module
adresine gönderilebilen PSRepositoryItemInfo nesneleri oluşturur. İşlem hattı, tek bir komutta yüklenecek birden çok modülü belirtmenin başka bir yoludur.
Varsayılan olarak, AllUsers kapsamına yönelik modüller içinde $env:ProgramFiles\PowerShell\Modules
yüklenir. Varsayılan ayar, PowerShell Desired State Configuration (DSC) kaynaklarını yüklediğinizde karışıklığı önler.
Klasör içinde , veya .dll
aynı ada sahip olmayan bir .psm1
.psd1
modül yüklemesi başarısız olur ve içeri aktarılamaz. Modülü yüklemek için Force parametresini kullanın.
Mevcut modülün sürümü Name parametresi tarafından belirtilen adla eşleşiyorsa ve MinimumVersion veya RequiredVersion parametresi kullanılmıyorsa sessizce Install-Module
devam eder ancak modülü yüklemez.
Mevcut bir modülün sürümü MinimumVersion parametresinin değerinden büyükse veya RequiredVersion parametresinin değerine eşitse sessizce Install-Module
devam eder ancak modülü yüklemez.
Mevcut modül MinimumVersion veya RequiredVersion parametreleri tarafından belirtilen değerlerle eşleşmiyorsa, komutta Install-Module
bir hata oluşur. Örneğin, mevcut yüklü modülün sürümü MinimumVersion değerinden düşükse veya RequiredVersion değerine eşit değilse.
Install-Module
ayrıca modül yayımcısının gerektirdiği şekilde belirtilen bağımlı modülleri yükler.
Yayımcı gerekli modülleri ve bunların sürümlerini modül bildiriminde listeler.
İlişkili Bağlantılar
PSResourceGet
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin