Install-Module

Sözdizimi

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

Install-Module cmdlet'i, ç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.PSResourceGetiçindeki Get-InstalledPSResource cmdlet'i 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-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ı Install-Module cmdlet'ine gönderilir. Install-Module $env:ProgramFiles\PowerShell\Modulesiçindeki tüm kullanıcılar iç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ü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üklenir. 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 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-Module, PowerShellGet modülünü belirtmek için Name parametresini kullanır. Install-Module PowerShellGet'in en yeni sürümünü geçerli kullanıcının dizinine indirip $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. Yayın öncesi sürümü 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. Find-Module cmdlet'i, PowerShell Galerisi'nde modüllerin yayın öncesi sürümlerini bulmak için kullanılabilir.

Yayın öncesi sürümleri <version_number>-<prerelease_label>biçimindedir.

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

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Girişler

PSRepositoryItemInfo

Find-Module, Install-Moduleişlem hattına 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 oluşturur. Bu, Find-Module cmdlet'inden edindiğiniz bilgilerle 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.

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 Install-Module bir hata döndürür.

Birden çok modül yüklemek için Name parametresini kullanın ve virgülle ayrılmış bir modül adları dizisi belirtin. Birden çok modül adı belirtirseniz, MinimumVersion, MaximumVersionveya RequiredVersionkullanamazsınız. Find-Module, Install-Moduleişlem hattına 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 $env:ProgramFiles\PowerShell\Modules'de yüklenir. PowerShell İstenen Durum Yapılandırması (DSC) kaynaklarını yüklediğinizde varsayılan ayar karışıklığı önler.

Klasör içinde aynı ada sahip bir .psm1, .psd1veya .dll yoksa modül yüklemesi başarısız olur ve içeri aktarılamaz. Modülü yüklemek için Zorla 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, Install-Module sessizce 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, Install-Module sessizce devam eder ancak modülü yüklemez.

Mevcut modül MinimumVersion veya RequiredVersion parametreleri tarafından belirtilen değerlerle eşleşmiyorsa, komutunda 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 de yükler. Yayımcı gerekli modülleri ve bunların sürümlerini modül bildiriminde listeler.

İlişkili Bağlantılar

• Find-Module
• Get-PSRepository
• Import-Module
• Publish-Module
• Register-PSRepository
• Uninstall-Module
• Update-Module
• about_Module