インストールし、Visual Studio (PowerShell) でパッケージ マネージャー コンソールを使用してパッケージの管理Install and manage packages with the Package Manager Console in Visual Studio (PowerShell)

NuGet パッケージ マネージャー コンソールを使用できます。 NuGet PowerShell コマンド見つけるには、インストール、アンインストール、および NuGet パッケージを更新します。The NuGet Package Manager Console lets you use NuGet PowerShell commands to find, install, uninstall, and update NuGet packages. コンソールを使用することは、パッケージ マネージャー UI が操作を実行する方法を提供しない場合に必要があります。Using the console is necessary in cases where the Package Manager UI does not provide a way to perform an operation. 使用するnuget.exeコンソールで、CLI コマンドを参照してくださいコンソールで nuget.exe CLI を使用してします。To use nuget.exe CLI commands in the console, see Using the nuget.exe CLI in the console.

コンソールは、Windows 上の Visual Studio に組み込まれています。The console is built into Visual Studio on Windows. これは Visual Studio for Mac または Visual Studio Code に含まれません。It is not included with Visual Studio for Mac or Visual Studio Code.

検索して、パッケージをインストールします。Find and install a package

などの検索とインストール パッケージは、次の 3 つの簡単なステップで行われます。For example, finding and installing a package is done with three easy steps:

  1. Visual Studio で、プロジェクト/ソリューションを開き、コンソールを使用して、開く、ツール > NuGet パッケージ マネージャー > パッケージ マネージャー コンソールコマンド。Open the project/solution in Visual Studio, and open the console using the Tools > NuGet Package Manager > Package Manager Console command.

  2. インストールするパッケージを検索します。Find the package you want to install. この既にわかっている場合は、手順 3. に進みます。If you already know this, skip to step 3.

    # Find packages containing the keyword "elmah"
    Find-Package elmah
    
  3. インストール コマンドを実行します。Run the install command:

    # Install the Elmah package to the project named MyProject.
    Install-Package Elmah -ProjectName MyProject
    

重要

コンソールで利用できるすべての操作を実行することも、 NuGet CLIします。All operations that are available in the console can also be done with the NuGet CLI. ただし、コンソールのコマンドは、Visual Studio と保存されているプロジェクト/ソリューションのコンテキスト内で動作し、多くの場合、その同等の CLI コマンドよりも多くの作業します。However, console commands operate within the context of Visual Studio and a saved project/solution and often accomplish more than their equivalent CLI commands. たとえば、コンソールを使用してパッケージをインストールする追加しますプロジェクトへの参照を CLI コマンドは実行されません。For example, installing a package through the console adds a reference to the project whereas the CLI command does not. このため、通常 Visual Studio で作業する開発者は、CLI にコンソールを使用してを優先します。For this reason, developers working in Visual Studio typically prefer using the console to the CLI.

ヒント

多くのコンソール操作は、既知のパスの名前を Visual Studio で開いたソリューションに依存します。Many console operations depend on having a solution opened in Visual Studio with a known path name. エラーが発生したことができます、保存されていないソリューションまたはソリューションがない場合、"ソリューションが開かれていないか、保存されません。If you have an unsaved solution, or no solution, you can see the error, "Solution is not opened or not saved. 確認してください、オープンと保存されているソリューションがある。"Please ensure you have an open and saved solution." これは、コンソールがソリューション フォルダーを判断できないことを示します。This indicates that the console cannot determine the solution folder. 保存されていないソリューションでは、保存または作成し、お持ちでない場合は、ソリューションを保存、開き、エラーを修正する必要があります。Saving an unsaved solution, or creating and saving a solution if you don't have one open, should correct the error.

コンソールを開き、コンソールのコントロールOpening the console and console controls

  1. Visual Studio を使用して、コンソールを開き、ツール > NuGet パッケージ マネージャー > パッケージ マネージャー コンソールコマンド。Open the console in Visual Studio using the Tools > NuGet Package Manager > Package Manager Console command. コンソールは、配置および自由に配置できる Visual Studio のウィンドウ (を参照してくださいVisual Studio でのウィンドウ レイアウトをカスタマイズ)。The console is a Visual Studio window that can be arranged and positioned however you like (see Customize window layouts in Visual Studio).

  2. 既定では、コンソール コマンドは、特定のパッケージのソースとのプロジェクトに対して、ウィンドウの上部にあるコントロールで設定されている動作します。By default, console commands operate against a specific package source and project as set in the control at the top of the window:

    パッケージ ソース ファイルおよびプロジェクトのパッケージ マネージャー コンソール コントロール

  3. 後続のコマンドの既定の設定を変更する別のパッケージのソースまたはプロジェクトを選択します。Selecting a different package source and/or project changes those defaults for subsequent commands. 上書きを既定値を変更することがなくこれらの設定のほとんどのコマンドをサポートして-Source-ProjectNameオプション。To overrride these settings without changing the defaults, most commands support -Source and -ProjectName options.

  4. パッケージ ソースを管理するには、歯車アイコンを選択します。To manage package sources, select the gear icon. これへのショートカット、ツール > オプション > NuGet パッケージ マネージャー > パッケージ ソース ダイアログ ボックスでの説明に従って、パッケージ マネージャー UIページ。This is a shortcut to the Tools > Options > NuGet Package Manager > Package Sources dialog box as described on the Package Manager UI page. また、プロジェクト セレクターの右側に、コントロールは、コンソールの内容をクリアします。Also, the control to the right of the project selector clears the console's contents:

    パッケージ マネージャー コンソールの設定およびコントロールのクリア

  5. 一番右のボタンは、実行時間の長いコマンドを中断します。The rightmost button interrupts a long-running command. たとえば、実行しているGet-Package -ListAvailable -PageSize 500上位 500 のパッケージを実行するのに数分かかる場合があります (など、nuget.org の場合) には、既定のソースを一覧表示されます。For example, running Get-Package -ListAvailable -PageSize 500 lists the top 500 packages on the default source (such as nuget.org), which could take several minutes to run.

    パッケージ マネージャー コンソール ストップ コントロール

パッケージをインストールします。Installing a package

# Add the Elmah package to the default project as specified in the console's project selector
Install-Package Elmah

# Add the Elmah package to a project named UtilitiesLib that is not the default
Install-Package Elmah -ProjectName UtilitiesLib

参照してくださいInstall-packageします。See Install-Package.

説明に従って、同じ手順を実行、コンソールでパッケージをインストールするパッケージがインストールされているときに起こる、次の項目を追加。Installing a package in the console performs the same steps as described on What happens when a package is installed, with the following additions:

  • コンソールには、暗黙的な契約書には、そのウィンドウで該当するライセンス条項が表示されます。The Console displays applicable license terms in its window with implied agreement. 条項に同意しない場合は、すぐに、パッケージをアンインストールする必要があります。If you do not agree to the terms, you should uninstall the package immediately.
  • パッケージへの参照はプロジェクト ファイルに追加されに表示されますソリューション エクスプ ローラー下、参照ノード、プロジェクト ファイル内の変更を直接表示するプロジェクトを保存する必要があります。Also a reference to the package is added to the project file and appears in Solution Explorer under the References node, you need to save the project to see the changes in the project file directly.

パッケージをアンインストールします。Uninstalling a package

# Uninstalls the Elmah package from the default project
Uninstall-Package Elmah

# Uninstalls the Elmah package and all its unused dependencies
Uninstall-Package Elmah -RemoveDependencies 

# Uninstalls the Elmah package even if another package depends on it
Uninstall-Package Elmah -Force

参照してくださいUninstall-packageします。See Uninstall-Package. 使用Get-packageに識別子を検索する必要がある場合、既定のプロジェクトにインストールされているすべてのパッケージを参照してください。Use Get-Package to see all packages currently installed in the default project if you need to find an identifier.

パッケージをアンインストールするには、次の操作は実行します。Uninstalling a package performs the following actions:

  • プロジェクト (および使用されている管理形式) から、パッケージへの参照を削除します。Removes references to the package from the project (and whatever management format is in use). 参照が表示されなくソリューション エクスプ ローラーします。References no longer appear in Solution Explorer. (表示から削除するプロジェクトをリビルドする必要があります、 Binフォルダー)。(You might need to rebuild the project to see it removed from the Bin folder.)
  • 加えられた変更を反転させますapp.configまたはweb.configパッケージがインストールされている場合。Reverses any changes made to app.config or web.config when the package was installed.
  • 以前にインストールされている削除残存するパッケージがこれらの依存関係を使用しない場合は、依存関係。Removes previously-installed dependencies if no remaining packages use those dependencies.

パッケージの更新Updating a package

# Checks if there are newer versions available for any installed packages
Get-Package -updates

# Updates a specific package using its identifier, in this case jQuery
Update-Package jQuery

# Update all packages in the project named MyProject (as it appears in Solution Explorer)
Update-Package -ProjectName MyProject

# Update all packages in the solution
Update-Package

参照してくださいGet-package更新プログラム パッケージSee Get-Package and Update-Package

パッケージの検索Finding a package

# Find packages containing keywords
Find-Package elmah
Find-Package logging

# List packages whose ID begins with Elmah
Find-Package Elmah -StartWith

# By default, Get-Package returns a list of 20 packages; use -First to show more
Find-Package logging -First 100

# List all versions of the package with the ID of "jquery"
Find-Package jquery -AllVersions -ExactMatch

参照してくださいFind-packageします。See Find-Package. Visual Studio 2013 以降を使用して、 Get-package代わりにします。In Visual Studio 2013 and earlier, use Get-Package instead.

コンソールの可用性Availability of the console

Visual Studio 2017 以降、NuGet、NuGet パッケージ マネージャーが自動的にインストールを選択します。NET に関連するワークロードです。チェックして個別にインストールもできる、個々 のコンポーネント > コード ツール > NuGet パッケージ マネージャー Visual Studio インストーラーでオプションです。Starting in Visual Studio 2017, NuGet and the NuGet Package Manager are automatically installed when you select any .NET-related workloads; you can also install it individually by checking the Individual components > Code tools > NuGet package manager option in the Visual Studio installer.

また、NuGet パッケージ マネージャー Visual Studio 2015 以前のバージョンでは不足しているが場合、確認ツール > 拡張機能と更新しています. して NuGet パッケージ マネージャー拡張機能を検索します。Also, if you're missing the NuGet Package Manager in Visual Studio 2015 and earlier, check Tools > Extensions and Updates... and search for the NuGet Package Manager extension. 直接、拡張機能をダウンロードするには Visual Studio の拡張機能インストーラーを使用する場合は、 https://dist.nuget.org/index.htmlします。If you're unable to use the extensions installer in Visual Studio, you can download the extension directly from https://dist.nuget.org/index.html.

パッケージ マネージャー コンソールを Visual Studio for mac で現在ご利用いただけませんThe Package Manager Console is not presently available with Visual Studio for Mac. 同等のコマンドでは、ただしを利用、 NuGet CLIします。The equivalent commands, however, are available through the NuGet CLI. Visual Studio for Mac は NuGet パッケージを管理するための UI が。Visual Studio for Mac does have a UI for managing NuGet packages. 参照してくださいを含む NuGet パッケージをプロジェクトにします。See Including a NuGet package in your project.

パッケージ マネージャー コンソールでは、Visual Studio のコードに含まれません。The Package Manager Console is not included with Visual Studio Code.

パッケージ マネージャー コンソールを拡張します。Extending the Package Manager Console

一部のパッケージは、コンソールの新しいコマンドをインストールします。Some packages install new commands for the console. たとえば、MvcScaffoldingなどのコマンドを作成します。Scaffold下図のように生成する ASP.NET MVC コント ローラーとビュー。For example, MvcScaffolding creates commands like Scaffold shown below, which generates ASP.NET MVC controllers and views:

インストールと MvcScaffold の使用

NuGet PowerShell プロファイルの設定Setting up a NuGet PowerShell profile

PowerShell プロファイルには、PowerShell を使用する場合、一般的に使用されるコマンドを使用できるようにすることができます。A PowerShell profile lets you make commonly-used commands available wherever you use PowerShell. NuGet は、通常、次の場所にある特定の NuGet プロファイルをサポートしています。NuGet supports a NuGet-specific profile typically found at the following location:

%UserProfile%\Documents\WindowsPowerShell\NuGet_profile.ps1

プロファイルを検索するには、次のように入力します。$profileコンソール。To find the profile, type $profile in the console:

$profile
C:\Users\<user>\Documents\WindowsPowerShell\NuGet_profile.ps1

詳細についてを参照してくださいWindows PowerShell プロファイルします。For more details, refer to Windows PowerShell Profiles.

コンソールで nuget.exe CLI を使用してください。Using the nuget.exe CLI in the console

させる、 nuget.exe CLI 、パッケージ マネージャー コンソールで使用可能なインストール、 NuGet.CommandLineコンソールからのパッケージ。To make the nuget.exe CLI available in the Package Manager Console, install the NuGet.CommandLine package from the console:

# Other versions are available, see http://www.nuget.org/packages/NuGet.CommandLine/
Install-Package NuGet.CommandLine -Version 4.4.1