Instalace balíčku (konzola Správce balíčků v sadě Visual Studio)

  • Článek

Toto téma popisuje příkaz v konzole Správce balíčků v sadě Visual Studio ve Windows. Obecný příkaz Install-Package PowerShellu najdete v referenčních informacích k rutině PackageManagement prostředí PowerShell.

Nainstaluje balíček a jeho závislosti do projektu.

Syntaxe

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

V NuGetu 2.8 nebo novějším Install-Package můžete downgradovat existující balíček v projektu. Pokud máte například nainstalovaný Microsoft.AspNet.MVC 5.1.0-rc1, následující příkaz by ho downgradoval na 5.0.0:

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

Parametry

Parametr Popis
Id (Povinné) Identifikátor balíčku, který se má nainstalovat. (3.0+) Identifikátor může být cesta nebo adresa URL packages.config souboru nebo .nupkg souboru. Samotný přepínač -ID je volitelný.
IgnoreDependencies Nainstalujte pouze tento balíček, nikoli jeho závislosti.
Název projektu Projekt, do kterého se má balíček nainstalovat, ve výchozím nastavení je výchozí projekt.
Source Adresa URL nebo cesta ke složce zdroje balíčku, která se má prohledávat. Cesty k místní složce můžou být absolutní nebo relativní vzhledem k aktuální složce. Pokud tento parametr vynecháte, Install-Package vyhledá aktuálně vybraný zdroj balíčku.
Verze Verze balíčku, která se má nainstalovat, ve výchozím nastavení na nejnovější verzi.
IncludePrerelease Bere v úvahu předběžné verze balíčků pro instalaci. Pokud tento parametr vynecháte, zvažují se pouze stabilní balíčky.
FileConflictAction Akce, která se má provést, když se zobrazí výzva k přepsání nebo ignorování existujících souborů odkazovaných projektem. Možné hodnoty jsou Přepsání, Ignore, None, OverwriteAll a (3.0+)IgnoreAll.
DependencyVersion Verze balíčků závislostí, které se mají použít, což může být jedna z následujících možností:
  • Nejnižší (výchozí): nejnižší verze
  • HighestPatch: verze s nejnižším hlavním, nejnižším podverzem, nejvyšší opravou
  • HighestMinor: verze s nejnižší hlavní, nejvyšší podverze, nejvyšší oprava
  • Nejvyšší (výchozí hodnota pro Update-Package bez parametrů): nejvyšší verze
Výchozí hodnotu můžete nastavit pomocí dependencyVersion nastavení v Nuget.Config souboru.
WhatIf Ukazuje, co se stane při spuštění příkazu bez skutečného provedení instalace.

Žádný z těchto parametrů nepřijímá vstup kanálu nebo zástupné znaky.

Běžné parametry

Install-Package podporuje následující běžné parametry PowerShellu: Ladění, Akce chyby, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction a WarningVariable.

Příklady

# 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