Install-Package (konsola Menedżer pakietów w programie Visual Studio)

  • Artykuł

W tym temacie opisano polecenie w konsoli Menedżer pakietów w programie Visual Studio w systemie Windows. Ogólne polecenie Install-Package programu PowerShell można znaleźć w dokumentacji dotyczącej pakietu programu PowerShell.

Instaluje pakiet i jego zależności w projekcie.

Składnia

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

W programie NuGet 2.8 lub nowszym Install-Package można obniżyć istniejący pakiet w projekcie. Jeśli na przykład masz zainstalowany program Microsoft.AspNet.MVC 5.1.0-rc1, następujące polecenie obniży jego wersję do wersji 5.0.0:

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

Parametry

Parametr Opis
Id (Wymagane) Identyfikator pakietu do zainstalowania. (3.0+) Identyfikator może być ścieżką lub adresem URL packages.config pliku lub .nupkg pliku. Przełącznik -Id jest opcjonalny.
IgnoreDependencies Zainstaluj tylko ten pakiet, a nie jego zależności.
ProjectName Projekt, do którego ma zostać zainstalowany pakiet, domyślnie domyślny projekt.
Źródło Adres URL lub ścieżka folderu źródła pakietu do wyszukania. Ścieżki folderów lokalnych mogą być bezwzględne lub względem bieżącego folderu. Jeśli pominięto, Install-Package przeszukuje aktualnie wybrane źródło pakietu.
Wersja Wersja pakietu do zainstalowania, domyślnie ustawiona na najnowszą wersję.
Uwzględnij wersję wstępną Uwzględnia pakiety wersji wstępnej dla instalacji. Jeśli pominięto, brane są pod uwagę tylko stabilne pakiety.
FileConflictAction Akcja do wykonania po wyświetleniu monitu o zastąpienie lub zignorowanie istniejących plików przywoływanych przez projekt. Możliwe wartości to Zastąp, Ignoruj, Brak, OverwriteAll i (3.0+)IgnoreAll.
DependencyVersion Wersja pakietów zależności do użycia, która może być jedną z następujących opcji:
  • Najniższa (domyślna ): najniższa wersja
  • Najwyższapatch: wersja z najniższym głównym, najniższym mniejszą poprawką pomocniczą, najwyższą poprawką
  • HighestMinor: wersja o najniższym numerze głównym, najwyższa wersja pomocnicza, najwyższa poprawka
  • Najwyższy (wartość domyślna dla pakietu Update-Package bez parametrów): najwyższa wersja
Wartość domyślną można ustawić przy użyciu dependencyVersion ustawienia w Nuget.Config pliku .
Instrukcja WhatIf Pokazuje, co się stanie podczas uruchamiania polecenia bez faktycznego wykonania instalacji.

Żaden z tych parametrów nie akceptuje znaków wejściowych potoku lub symboli wieloznacznych.

Typowe parametry

Install-Package obsługuje następujące typowe parametry programu PowerShell: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction i WarningVariable.

Przykłady

# 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