Install-Module

Başvuru

Modül:: PowerShellGet

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-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ına 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 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üklenir.

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, 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ü indirip 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ü 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-PSResourcedesteklenmediğ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-PSResourcekullanı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-PSResourcekullanı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-PSResourcedesteklenmediğ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-PSResourcedesteklenmediğ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-PSResourcekullanı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-Moduleadresine gönderilebilen PSRepositoryItemInfo 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 çıkarır. Bu, cmdlet'ten edindiğiniz bilgilerle Find-Module aynıdır.

Notlar

PowerShell, için Install-Moduleaş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-Moduleadresine 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\Modulesyü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.psd1modü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.

Install-Module

Syntax

Description

Örnekler

Örnek 1: Modül bulma ve yükleme

Örnek 2: Modülü ada göre yükleme

Örnek 3: En düşük sürümünü kullanarak modül yükleme

Örnek 4: Modülün belirli bir sürümünü yükleme

Örnek 5: Modülü yalnızca geçerli kullanıcı için yükleme

Örnek 6: Modülün en son yayın öncesi sürümünü yükleme

Örnek 7: Modülün belirli bir yayın öncesi sürümünü yükleme

Parametreler

-AcceptLicense

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Install-Module

Syntax

Description

Örnekler

Örnek 1: Modül bulma ve yükleme

Örnek 2: Modülü ada göre yükleme

Örnek 3: En düşük sürümünü kullanarak modül yükleme

Örnek 4: Modülün belirli bir sürümünü yükleme

Örnek 5: Modülü yalnızca geçerli kullanıcı için yükleme

Örnek 6: Modülün en son yayın öncesi sürümünü yükleme

Örnek 7: Modülün belirli bir yayın öncesi sürümünü yükleme

Parametreler

-AcceptLicense

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar