Install-Module
Bir depodan bir veya daha fazla modül indirir ve bunları yerel bilgisayara yükler.
Sözdizimi
NameParameterSet EnterprisePublishing
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>]
InputObject
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, Get-InstalledPSResource içindeki cmdlet için bir proxy cmdlet'idir. Daha fazla bilgi için bkz . Install-PSResource.
Örnekler
Örnek 1: Modül bulma ve yükleme
Bu örnek, depoda bir modül bulur ve modülü yükler.
Find-Module -Name PowerShellGet | Install-Module
, Find-ModulePowerShellGet 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ı Install-Module cmdlet'ine gönderilir.
Install-Module içindeki tüm kullanıcılar $env:ProgramFiles\PowerShell\Modulesiçin modülü yükler.
Örnek 2: Ada göre bir modül yükleme
Bu örnekte PowerShellGet modülünün en yeni sürümü yüklüdür.
Install-Module -Name PowerShellGet
, Install-ModulePowerShellGet 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-ModulePowerShellGet 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üklüdür.
Install-Module -Name PowerShellGet -RequiredVersion 2.0.0
, Install-ModulePowerShellGet 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 indirilip 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-ModulePowerShellGet modülünü belirtmek için Name parametresini kullanır.
Install-Module
PowerShellGet'in en yeni sürümünü indirir ve geçerli kullanıcının dizinine $HOME\Documents\PowerShell\Modulesyü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ü elde edersiniz. En son sürüm bir ö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'nde modüllerin yayın öncesi sürümlerini bulmak için kullanılabilir.
Yayın öncesi sürümlerin biçimi vardır <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'nde 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 komutunda Install-Module birlikte kullanılabilir.
Proxy cmdlet'i, bu parametrenin değerini cmdlet'in NoClobber parametresine Install-PSResource dönüştürür.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
NameParameterSet
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Confirm
Install-Module cmdlet'ini çalıştırmadan önce sizden onay ister.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Cf |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Belirtilen paket sağlayıcısı veya kaynağı için modül yükleme haklarına sahip bir kullanıcı hesabı belirtir.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Force
proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-InputObject
İşlem hattı girişi için kullanılır. InputObject'e doğrudan bir değer sağlanırsa bir hata oluşur. InputObject parametresiyle nesneleri geçirmek için işlem hattını kullanın.
Parametre özellikleri
| Tür: | PSObject[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
InputObject
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-MaximumVersion
Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
NameParameterSet
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-MinimumVersion
Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
NameParameterSet
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 .
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
NameParameterSet
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-PassThru
PassThru parametresini kullanırken, Install-Module modül için bir PSRepositoryItemInfo nesnesi çıkartır. Bu, cmdlet'inden edindiğiniz bilgilerle Find-Module aynıdır.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Proxy
proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ProxyCredential
proxy cmdlet'i tarafından Install-PSResourcedesteklenmediğinden bu parametreyi yoksayar.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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. Bir depo kaydetmek için kullanın Register-PSRepository.
Kayıtlı depoları görüntülemek için kullanın Get-PSRepository.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
NameParameterSet
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-RequiredVersion
Proxy cmdlet'i bu parametrenin değerini kullanarak version parametresiyleInstall-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
NameParameterSet
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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
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'tı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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Kabul edilen değerler: | CurrentUser, AllUsers |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-SkipPublisherCheck
Proxy cmdlet'i çağırmadan önce bu parametreyi Install-PSResource olarak dönüştürür.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-WhatIf
Bir Install-Module komut çalıştırıldığında ne olacağını gösterir. Cmdlet çalıştırılmıyor.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | False |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Wi |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
PSRepositoryItemInfo
Find-Module, işlem hattına gönderilebilen Install-Module nesneleri oluşturur.
String
PSObject
String
PSCredential
Uri
Çıkışlar
Microsoft.PowerShell.Commands.PSRepositoryItemInfo
PassThru parametresini kullanırken, Install-Module modül için bir PSRepositoryItemInfo nesnesi çıkartır. Bu, cmdlet'inden edindiğiniz bilgilerle Find-Module aynıdır.
Notlar
PowerShell, Install-Moduleiçin 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 üzeri 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'ne erişmeye çalışırken 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 blogunda duyuru 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ıştırılması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 Ad 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ına gönderilebilen Install-Module 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\Modulesyüklenir. PowerShell İstenen Durum Yapılandırması (DSC) kaynaklarını yüklediğinizde varsayılan ayar karışıklığı önler.
Modül yüklemesi başarısız olur ve klasör içinde aynı ada sahip .psm1bir , .psd1veya .dll yoksa 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 tüm bağımlı modülleri yükler.
Yayımcı gerekli modülleri ve bunların sürümlerini modül bildiriminde listeler.
