Install-Package

Başvuru

Modül:: PackageManagement

Bir veya daha fazla yazılım paketi yükler.

Syntax

Install-Package
       [-Name] <String[]>
       [-RequiredVersion <String>]
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-Source <String[]>]
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ProviderName <String[]>]
       [<CommonParameters>]

Install-Package
       [-InputObject] <SoftwareIdentity[]>
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-ConfigFile <String>]
       [-SkipValidate]
       [-Headers <String[]>]
       [-FilterOnTag <String[]>]
       [-Contains <String>]
       [-AllowPrereleaseVersions]
       [-Destination <String>]
       [-ExcludeVersion]
       [-Scope <String>]
       [-SkipDependencies]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Install-Package
       [-Credential <PSCredential>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllVersions]
       [-Force]
       [-ForceBootstrap]
       [-WhatIf]
       [-Confirm]
       [-AllowPrereleaseVersions]
       [-Scope <String>]
       [-PackageManagementProvider <String>]
       [-PublishLocation <String>]
       [-ScriptSourceLocation <String>]
       [-ScriptPublishLocation <String>]
       [-Type <String>]
       [-Filter <String>]
       [-Tag <String[]>]
       [-Includes <String[]>]
       [-DscResource <String[]>]
       [-RoleCapability <String[]>]
       [-Command <String[]>]
       [-AcceptLicense]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-InstallUpdate]
       [-NoPathUpdate]
       [<CommonParameters>]

Description

cmdlet'i Install-Package yerel bilgisayara bir veya daha fazla yazılım paketi yükler. Birden çok yazılım kaynağınız varsa, sağlayıcılarınız hakkındaki ayrıntıları görüntülemek için ve Get-PackageSource kullanınGet-PackageProvider.

Önemli

PackageManagement modülünde yer alan komutlar, Visual Studio'nun Paket Yöneticisi Konsolu'ndaki NuGet modülü tarafından sağlanan komutlardan farklıdır. Her modülün diğerinde bulunmayan komutları vardır. Aynı ada sahip komutlar kendi bağımsız değişkenlerinde farklılık gösterir. Daha fazla bilgi için Visual Studio Paket Yöneticisi Konsolu için PowerShell başvuru belgelerine bakın.

Örnekler

Örnek 1: Paket adına göre paket yükleme

cmdlet'i Install-Package bir yazılım paketi ve bağımlılıklarını yükler.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -Credential Contoso\TestUser

Install-Package , Ad ve Kaynak paketlerini belirtmek için parametreleri kullanır. Credential parametresi, paketleri yükleme izinlerine sahip bir etki alanı kullanıcı hesabı kullanır. Komut sizden kullanıcı hesabı parolasını ister.

Örnek 2: Paket yüklemek için Find-Package kullanma

Bu örnekte, tarafından Find-Package döndürülen nesnesi işlem hattına gönderilir ve tarafından Install-Packageyüklenir.

PS> Find-Package -Name NuGet.Core -Source MyNuGet | Install-Package

Find-Package bir paketi bulmak için Ad ve Kaynak parametrelerini kullanır. nesnesi işlem hattına gönderilir ve Install-Package paketi yerel bilgisayara yükler.

Örnek 3: Bir sürüm aralığı belirterek paketleri yükleme

Install-Package bir dizi yazılım sürümünü belirtmek için MinimumVersion ve MaximumVersion parametrelerini kullanır.

PS> Install-Package -Name NuGet.Core -Source MyNuGet -MinimumVersion 2.8.0 -MaximumVersion 2.9.0

Install-Package Bir paketi bulmak için Ad ve Kaynak parametrelerini kullanır. MinimumVersion ve MaximumVersion parametreleri bir dizi yazılım sürümü belirtir. Aralıktaki en yüksek sürüm yüklenir.

Parametreler

-AcceptLicense

AcceptLicense , yükleme sırasında lisans sözleşmesini otomatik olarak kabul eder.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowClobber

Var olan komutlarla çakışmalar hakkındaki uyarı iletilerini geçersiz kılar. Yüklenen komutlar ile aynı ada sahip mevcut komutların üzerine yazar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPrereleaseVersions

Ön sürüm olarak işaretlenmiş paketlerin yüklenmesine izin verir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AllVersions

Install-Package paketin tüm kullanılabilir sürümlerini yükler. Varsayılan olarak, yalnızca en yeni sürüm yüklenir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Command

Arama yapılan Install-Package bir veya daha fazla komutu belirtir.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ConfigFile

Yapılandırma dosyası içeren bir yol belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Cmdlet'i çalıştırmadan önce sizden onay ister.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Contains

Install-PackageContains parametresi nesnenin özellik değerlerinden herhangi biri ile eşleşen bir değer belirtirse nesneleri alır.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Bilgisayara erişme ve komutları çalıştırma izni olan bir kullanıcı hesabı belirtir. User01, Domain01\User01 gibi bir kullanıcı adı yazın veya cmdlet tarafından Get-Credential oluşturulan bir PSCredential nesnesi girin. Bir kullanıcı adı yazarsanız parola girmeniz istenir.

Credential parametresi belirtilmediğinde geçerli Install-Package kullanıcıyı kullanır.

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Destination

Giriş nesnesinin yolunu belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DscResource

tarafından Install-Packagearanan bir veya daha fazla Desired State Configuration (DSC) kaynağını belirtir. Find-DscResource DSC kaynaklarını bulmak için cmdlet'ini kullanın.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExcludeVersion

Klasör yolundaki sürüm numarasını dışlamak için geçiş yapın.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Filter

Ad ve Açıklama özellikleri içinde aranacak terimleri belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FilterOnTag

Sonuçları filtreleyen ve belirtilen etiketi içermeyen sonuçları dışlayan bir etiket belirtir.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Force

Komutu, kullanıcı onayı istemeden çalışmaya zorlar. Güvenlik dışında başarılı olmasını engelleyen Install-Package kısıtlamaları geçersiz kılar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ForceBootstrap

PackageManagement'ı belirtilen paket için paket sağlayıcısını otomatik olarak yüklemeye zorlar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Headers

Paket üst bilgilerini belirtir.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Includes

Tüm paket türlerinin bulunup bulunmayacağını Install-Package belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

Cmdlet
DscResource
İşlev
RoleCapability
İş akışı

Type:	String[]
Accepted values:	Cmdlet, DscResource, Function, RoleCapability, Workflow
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

İşlem hattı girişini kabul eder. Paketin SoftwareIdentity türünü kullanarak bir paket belirtir. Find-Package bir SoftwareIdentity nesnesinin çıkışını alır.

Type:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallUpdate

Güncelleştirmelerin yüklendiğini Install-Package gösterir.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

Yüklemek istediğiniz izin verilen en yüksek paket sürümünü belirtir. Bu parametreyi belirtmezseniz paketin Install-Package en yeni sürümünü yükler.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumVersion

Yüklemek istediğiniz izin verilen en düşük paket sürümünü belirtir. Bu parametreyi eklemezseniz, Install-Package paketin MaximumVersion parametresi tarafından belirtilen herhangi bir sürümü karşılayan en yeni sürümünü yükler.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Bir veya daha fazla paket adı belirtir. Birden çok paket adı virgülle ayrılmalıdır.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoPathUpdate

NoPathUpdate yalnızca cmdlet için Install-Script geçerlidir. NoPathUpdate , sağlayıcı tarafından eklenen dinamik bir parametredir ve tarafından Install-Packagedesteklenmez.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PackageManagementProvider

PackageManagement sağlayıcısının adını belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProviderName

Paket aramanızın kapsamının belirtildiği bir veya daha fazla paket sağlayıcısı adını belirtir. cmdlet'ini Get-PackageProvider çalıştırarak paket sağlayıcısı adlarını alabilirsiniz.

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

doğrudan bir internet kaynağına bağlanmak yerine istek için bir proxy sunucusu belirtir.

Type:	Uri
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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:	False
Accept wildcard characters:	False

-PublishLocation

Paketin yayımlanan konumunun yolunu belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredVersion

Yüklemek istediğiniz paketin tam olarak izin verilen sürümünü belirtir. Bu parametreyi eklemezseniz, Install-Package paketin MaximumVersion parametresi tarafından belirtilen herhangi bir sürümü karşılayan en yeni sürümünü yükler.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RoleCapability

Rol yetenekleri dizisini belirtir.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

Paketin yükleneceği kapsamı belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

CurrentUser
AllUsers

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptPublishLocation

Betiğin yayımlanmış konumunun yolunu belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptSourceLocation

Betik kaynağı konumunu belirtir.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipDependencies

Yazılım bağımlılıklarının yüklenmesini atlar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipPublisherCheck

Yüklü sürümünüzden daha yeni bir paket sürümü edinmenizi sağlar. Örneğin, güvenilir bir yayımcı tarafından dijital olarak imzalanan ancak yeni bir sürüm dijital olarak imzalanmamış yüklü bir paket.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipValidate

Paketin kimlik bilgilerini doğrulamayı atlayan anahtar.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Source

Bir veya daha fazla paket kaynağını belirtir. Birden çok paket kaynak adı virgülle ayrılmalıdır. cmdlet'ini Get-PackageSource çalıştırarak paket kaynak adlarını alabilirsiniz.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Tag

Paket meta verilerinde aranacak bir veya daha fazla dizeyi belirtir.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Type

Bir modül, betik veya her ikisi ile paketlerin aranıp aranmayacağını belirtir. Bu parametre için kabul edilebilir değerler şunlardır:

Modül
Komut Dosyası
Tümü

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

cmdlet çalıştırılırsa Install-Package 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

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Bir SoftwareIdentity nesnesini bu cmdlet'e yöneltebilirsiniz.

Çıkışlar

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Bu cmdlet, yüklemiş olduğu her paket için bir SoftwareIdentity nesnesi döndürür.

Notlar

Bir paket sağlayıcısını bir komuta eklemek, dinamik parametrelerin bir cmdlet için kullanılabilir olmasını sağlayabilir. Dinamik parametreler bir paket sağlayıcısına özeldir. cmdlet'i Get-Help bir cmdlet'in parametre kümelerini listeler ve sağlayıcının parametre kümesini içerir. Örneğin, Install-Package , AllowClobberve SkipPublisherCheckiçeren -NoPathUpdatePowerShellGet parametre kümesine sahiptir.

Ö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.

Share via

Install-Package

Syntax

Description

Örnekler

Örnek 1: Paket adına göre paket yükleme

Örnek 2: Paket yüklemek için Find-Package kullanma

Örnek 3: Bir sürüm aralığı belirterek paketleri yükleme

Parametreler

-AcceptLicense

-AllowClobber

-AllowPrereleaseVersions

-AllVersions

-Command

-ConfigFile

-Confirm

-Contains

-Credential

-Destination

-DscResource

-ExcludeVersion

-Filter

-FilterOnTag

-Force

-ForceBootstrap

-Headers

-Includes

-InputObject

-InstallUpdate

-MaximumVersion

-MinimumVersion

-Name

-NoPathUpdate

-PackageManagementProvider

-ProviderName

-Proxy

-ProxyCredential

-PublishLocation

-RequiredVersion

-RoleCapability

-Scope

-ScriptPublishLocation

-ScriptSourceLocation

-SkipDependencies

-SkipPublisherCheck

-SkipValidate

-Source

-Tag

-Type

-WhatIf

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar