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ılmaz.
Belirtilen modüllerin en düşük, en yüksek ve tam sürümlerine göre hangi modülün yüklendiğini filtreleyebilirsiniz.
Yüklenen modülün adı veya sürümü aynıysa veya mevcut bir modülde komutlar içeriyorsa uyarı iletileri görüntülenir. Modülü yüklemek ve uyarıları geçersiz kılmak istediğinizi onayladıktan sonra ve -AllowClobber parametrelerini kullanın-Force. Depo ayarlarınıza bağlı olarak, modül yüklemesinin devam etmesi için bir istem yanıtlamanız gerekebilir.
Bu örneklerde PowerShell Galerisi tek kayıtlı depo olarak kullanılır. Get-PSRepository kayıtlı depoları görüntüler. Birden çok kayıtlı deponuz varsa, deponun -Repository adını belirtmek için parametresini kullanın.
Ö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ı cmdlet'ine Install-Module gönderilir. Install-Module içindeki tüm kullanıcılar $env:ProgramFiles\PowerShell\Modulesiç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-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 bir 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 indirildiğini ve yüklendiğini belirtir.
Örnek 5: Modülü yalnızca geçerli kullanıcı için yükleme
Bu örnek, yalnızca geçerli kullanıcı için bir modülün 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-ModulePowerShellGet'in en yeni sürümünü indirip geçerli kullanıcının dizinine $home\Documents\PowerShell\Modulesyükler.
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
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.
| 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.
| 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
Bir modülü yükler ve modül yükleme çakışmalarıyla ilgili uyarı iletilerini geçersiz kılar. Bilgisayarda aynı ada sahip bir modül zaten varsa , Force birden çok sürümün yüklenmesine izin verir. Aynı ada ve sürüme sahip bir modül varsa , Zorla bu sürümün üzerine yazar. Force ve AllowClobber bir Install-Module komutta birlikte kullanılabilir.
| 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ğlanırsa bir 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
Yüklenecek tek bir modülün en yüksek sürümünü belirtir. Yüklenen sürüm MaximumVersion'dan küçük veya buna eşit olmalıdır. Birden çok modül yüklemek istiyorsanız MaximumVersion kullanamazsınız. MaximumVersion ve RequiredVersion aynı Install-Module komutta kullanılamaz.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MinimumVersion
Yüklenecek tek bir modülün en düşük sürümünü belirtir. Yüklenen sürüm MinimumVersion değerinden büyük veya buna eşit olmalıdır. Modülün daha yeni bir sürümü varsa, daha yeni sürüm yüklenir. Birden çok modül yüklemek istiyorsanız MinimumVersion kullanamazsınız.
MinimumVersion ve RequiredVersion aynı Install-Module komutta kullanılamaz.
| 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
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
doğrudan İnternet kaynağına bağlanmak yerine istek için bir ara sunucu belirtir.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Proxy parametresi tarafından belirtilen ara sunucuyu kullanma izni olan bir kullanıcı hesabı belirtir.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Bir modülü indirmek ve yüklemek için hangi deponun kullanılacağı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
Yüklenecek tek bir modülün tam sürümünü belirtir. Belirtilen sürüm için depoda eşleşme yoksa bir hata görüntülenir. Birden çok modül yüklemek istiyorsanız RequiredVersion kullanamazsınız. RequiredVersion, MinimumVersion veya MaximumVersion ile aynı Install-Module komutta kullanılamaz.
| 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. Örnek:
$home\Documents\PowerShell\Modules
Hiçbir Kapsam tanımlanmadığında, varsayılan değer PowerShellGet sürümüne göre ayarlanır.
- PowerShellGet 2.0.0 ve üzeri sürümlerde varsayılan değer CurrentUser'dır ve yükleme için yükseltme gerektirmez.
- PowerShellGet 1.x sürümlerinde varsayılan değer, yükleme için yükseltme gerektiren AllUsers'dır.
| Type: | String |
| Accepted values: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipPublisherCheck
Bilgisayarınızda zaten var olan bir modülün daha yeni bir sürümünü yüklemenize olanak tanır. Örneğin, mevcut bir modül güvenilir bir yayımcı tarafından dijital olarak imzalandığında ancak yeni sürüm güvenilir bir yayımcı tarafından dijital olarak imzalanmadığında.
| 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ılmaz.
| 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ına Install-Modulegönderilebilen PSRepositoryItemInfo nesnelerini 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'inden edindiğiniz bilgilerle Find-Module aynıdır.
Notlar
Install-Module , Windows 7 veya Windows 2008 R2 ve sonraki Windows sürümlerinde PowerShell 5.0 veya sonraki sürümlerinde ç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ıştırılmasını önlemek için, yüklenen modüller yüklemeden sonra otomatik olarak içeri aktarılmaz.
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 modül adlarından oluşan virgülle ayrılmış bir dizi belirtin. Birden çok modül adı belirtirseniz MinimumVersion, MaximumVersion veya RequiredVersion kullanamazsınız. Find-Module, işlem hattına Install-Modulegönderilebilen PSRepositoryItemInfo nesnelerini 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. Varsayılan ayar, PowerShell Desired State Configuration (DSC) kaynaklarını yüklediğinizde karışıklığı önler.
Bir 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 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.
Modül yüklemesi, modül yayımcısının gerektirdiği şekilde belirtilen bağımlı modülleri de yükler. Yayımcı, modül bildiriminde gerekli modülleri ve sürümlerini belirtir.