Install-Package (konsola menedżera pakietów w programie Visual Studio)Install-Package (Package Manager Console in Visual Studio)

W tym temacie opisano polecenia w ramach Konsola Menedżera pakietów w programie Visual Studio na Windows. Ogólne polecenia programu PowerShell Install-Package, zobacz dokumentacja programu PowerShell PackageManagement.This topic describes the command within the Package Manager Console in Visual Studio on Windows. For the generic PowerShell Install-Package command, see the PowerShell PackageManagement reference.

Instaluje pakiet i jego zależności do projektu.Installs a package and its dependencies into a project.

SkładniaSyntax

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

W pakiecie NuGet 2.8 + Install-Package mogą obniżyć wersję istniejącego pakietu w projekcie.In NuGet 2.8+, Install-Package can downgrade an existing package in your project. Na przykład w przypadku 5.1.0-rc1 Microsoft.AspNet.MVC zainstalowane następujące polecenie będzie obniżyć do 5.0.0:For example, if you have Microsoft.AspNet.MVC 5.1.0-rc1 installed, the following command would downgrade it to 5.0.0:

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

ParametryParameters

ParametrParameter OpisDescription
IdId (Wymagane) Identyfikator pakietu do zainstalowania.(Required) The identifier of the package to install. (3.0 + ) identyfikator może być ścieżka lub adres URL packages.config pliku lub .nupkg pliku.(3.0+) The identifier can be a path or URL of a packages.config file or a .nupkg file. — Identyfikator samym przełączniku jest opcjonalne.The -Id switch itself is optional.
IgnoreDependenciesIgnoreDependencies Zainstaluj tylko ten pakiet, a nie z jego zależności.Install only this package and not its dependencies.
ProjectNameProjectName Projekt, do którego można zainstalować pakietu, domyślnie używany będzie domyślny projekt.The project into which to install the package, defaulting to the default project.
SourceSource Adres URL lub folder ścieżka do źródła pakietu do wyszukania.The URL or folder path for the package source to search. Ścieżki folderu lokalnego, może być ścieżką bezwzględną, lub względną do bieżącego folderu.Local folder paths can be absolute, or relative to the current folder. W przypadku pominięcia Install-Package przeszukuje źródło obecnie wybranego pakietu.If omitted, Install-Package searches the currently selected package source.
WersjaVersion Wersja pakietu do zainstalowania, ustawiając domyślnie do najnowszej wersji.The version of the package to install, defaulting to the latest version.
IncludePrereleaseIncludePrerelease Uwzględnia pakiety w wersjach wstępnych instalacji.Considers prerelease packages for the install. Jeśli argument jest pominięty, są traktowane jako tylko stabilne pakiety.If omitted, only stable packages are considered.
FileConflictActionFileConflictAction Akcja do wykonania po wyświetleniu monitu o zastąpienie lub zignorować istniejące pliki przywoływanego przez projekt.The action to take when asked to overwrite or ignore existing files referenced by the project. Możliwe wartości to zastąpienia, Zignoruj, None, OverwriteAll, i (3.0 i nowsze) IgnoreAll.Possible values are Overwrite, Ignore, None, OverwriteAll, and (3.0+) IgnoreAll.
DependencyVersionDependencyVersion Wersja pakietów zależności do użycia, które może być jedną z następujących czynności:The version of the dependency packages to use, which can be one of the following:
  • Najniższy (ustawienie domyślne): Najniższa wersjaLowest (default): the lowest version
  • HighestPatch: wersja przy najniższe główne, najniższą pomocnicza, najwyższy poziom poprawkiHighestPatch: the version with the lowest major, lowest minor, highest patch
  • HighestMinor: wersji z najniższą główne, najwyższy pomocnicza, najwyższy poziom poprawkiHighestMinor: the version with the lowest major, highest minor, highest patch
  • Najwyższy (domyślnie dla pakietu aktualizacji bez parametrów): najwyższa wersjaHighest (default for Update-Package with no parameters): the highest version
Można ustawić przy użyciu wartości domyślnej dependencyVersion ustawienie w Nuget.Config pliku.You can set the default value using the dependencyVersion setting in the Nuget.Config file.
WhatIfWhatIf Pokazuje, co się stanie po uruchomieniu polecenia bez rzeczywistego wykonania instalacji.Shows what would happen when running the command without actually performing the install.

Żaden z tych parametrów akceptuje znaków potoku danych wejściowych lub symbol wieloznaczny.None of these parameters accept pipeline input or wildcard characters.

Wspólne parametryCommon Parameters

Install-Package obsługuje następujące typowe parametry programu PowerShell: Debugowanie, akcja w przypadku błędu, ErrorVariable, OutBuffer, OutVariable, PipelineVariable pełne, WarningAction i WarningVariable.Install-Package supports the following common PowerShell parameters: Debug, Error Action, ErrorVariable, OutBuffer, OutVariable, PipelineVariable, Verbose, WarningAction, and WarningVariable.

PrzykładyExamples

# 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
Install-package https://raw.githubusercontent.com/json-ld.net/master/src/JsonLD/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
Install-package https://az320820.vo.msecnd.net/packages/microsoft.aspnet.mvc.5.2.3.nupkg