Yükleme Paketi (Visual Studio'da Paket Yöneticisi Konsolu)

Bu konuda, Windows üzerinde Visual Studio'daki Paket Yöneticisi Konsolu'ndaki komut açıklanmaktadır. Genel PowerShell Install-Package komutu için bkz . PowerShell PackageManagement başvurusu.

Bir paketi ve bağımlılıklarını bir projeye yükler.

Sözdizimi

Install-Package [-Id] <string> [-IgnoreDependencies] [-ProjectName <string>] [[-Source] <string>] 
    [[-Version] <string>] [-IncludePrerelease] [-FileConflictAction] [-DependencyVersion]
    [-WhatIf] [<CommonParameters>]

NuGet 2.8+'da projenizdeki Install-Package mevcut bir paketin sürümünü düşürebilir. Örneğin, Microsoft.AspNet.MVC 5.1.0-rc1 yüklüyse, aşağıdaki komut bunu 5.0.0'a düşürecek:

Install-Package Microsoft.AspNet.MVC -Version 5.0.0.

Parametreler

Parametre Açıklama
Kimlik (Gerekli) Yüklenecek paketin tanımlayıcısı. (3.0+) Tanımlayıcı, bir dosyanın veya dosyanın yolu veya .nupkg URL'si packages.config olabilir. -Id anahtarının kendisi isteğe bağlıdır.
IgnoreDependencies Bağımlılıklarını değil yalnızca bu paketi yükleyin.
ProjectName Paketin yükleneceği proje, varsayılan olarak varsayılan projedir.
Source Aranacak paket kaynağının URL'si veya klasör yolu. Yerel klasör yolları mutlak veya geçerli klasöre göre olabilir. Atlanırsa, Install-Package seçili durumdaki paket kaynağını arar.
Sürüm Yüklenecek paketin sürümü, varsayılan olarak en son sürümdür.
IncludePrerelease Yükleme için yayın öncesi paketleri dikkate alır. Atlanırsa, yalnızca kararlı paketler dikkate alınır.
FileConflictAction Proje tarafından başvuruda bulunan mevcut dosyaların üzerine yazılmasını veya yoksayılmasını istendiğinde gerçekleştirecek eylem. Olası değerler Overwrite, Ignore, None, OverwriteAll ve (3.0+)IgnoreAll değerleridir.
DependencyVersion Kullanılacak bağımlılık paketlerinin sürümü, aşağıdakilerden biri olabilir:
  • En düşük (varsayılan): en düşük sürüm
  • HighestPatch: En düşük ana, en düşük ikincil, en yüksek düzeltme ekini içeren sürüm
  • HighestMinor: En düşük ana, en yüksek küçük, en yüksek düzeltme ekini içeren sürüm
  • En yüksek (parametre içermeyen Update-Package için varsayılan): en yüksek sürüm
Dosyadaki ayarı Nuget.Config kullanarak dependencyVersion varsayılan değeri ayarlayabilirsiniz.
WhatIf Yüklemeyi gerçekleştirmeden komutu çalıştırırken ne olacağını gösterir.

Bu parametrelerden hiçbiri işlem hattı girişini veya joker karakterlerini kabul etmemektedir.

Ortak Parametreler

Install-Package şu yaygın PowerShell parametrelerini destekler: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction ve WarningVariable.

Örnekler

# Installs the latest version of Elmah from the current source into the default project
Install-Package Elmah

# Installs Glimpse 1.0.0 into the MvcApplication1 project
Install-Package Glimpse -Version 1.0.0 -Project MvcApplication1

# Installs Ninject.Mvc3 but not its dependencies from c:\temp\packages
Install-Package Ninject.Mvc3 -IgnoreDependencies -Source c:\temp\packages

# Installs the package listed on the online packages.config into the current project
# Note: the URL must end with "packages.config"
Install-Package https://raw.githubusercontent.com/linked-data-dotnet/json-ld.net/master/.nuget/packages.config

# Installs jquery 1.10.2 package, using the .nupkg file under local path of c:\temp\packages
Install-Package c:\temp\packages\jQuery.1.10.2.nupkg

# Installs the specific online package
# Note: the URL must end with ".nupkg"
Install-Package https://globalcdn.nuget.org/packages/microsoft.aspnet.mvc.5.2.3.nupkg