Install-Package (konsola Menedżer pakietów w programie Visual Studio)
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 Overwrite, Ignore, None, 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:
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