dotnet ツールの更新

この記事の対象: ✔️ .NET Core 3.1 SDK 以降のバージョン

名前

dotnet tool update - コンピューター上の指定した .NET ツール を更新します。

概要

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --tool-path <PATH>
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive] 
    [--no-cache] [--prerelease]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update <PACKAGE_ID> --local
    [--add-source <SOURCE>] [--all] [--allow-downgrade]
    [--configfile <FILE>]
    [--disable-parallel] [--framework <FRAMEWORK>]
    [--ignore-failed-sources] [--interactive]
    [--no-cache] [--prerelease]
    [--tool-manifest <PATH>]
    [-v|--verbosity <LEVEL>] [--version <VERSION>]

dotnet tool update -h|--help

説明

dotnet tool update コマンドを使用すると、コンピューター上の .NET ツールを最新の安定バージョンのパッケージに更新できます。 このコマンドは、ツールをアンインストールして再インストールし、効果的に更新します。 このコマンドを使用するには、次のいずれかのオプションを指定します。

• 既定の場所にインストールされたグローバル ツールを更新するには、 --global オプションを使用します
• カスタムの場所にインストールされたグローバル ツールを更新するには、 --tool-path オプションを使用します。
• ローカル ツールを更新するには、 --local オプションを使用します。

論争

• PACKAGE_ID

  更新する .NET グローバル ツールを含む NuGet パッケージの名前/ID。 dotnet ツール リスト コマンドを使用して、パッケージ名を見つけることができます。

オプション

• --add-source <SOURCE>

  インストール時に使用するために追加の NuGet パッケージ ソースを追加します。 フィードは、何らかの順番ではなく、並列でアクセスされます。 同じパッケージとバージョンが複数のフィードに存在する場合、最も速いフィードが優先されます。 詳細については、「NuGet パッケージのインストールのしくみ」を参照してください。

• --all

  すべてのツールを更新します。

• --allow-downgrade

  .NET ツール パッケージをインストールまたは更新するときに、パッケージのダウングレードを許可します。 "要求されたバージョン x.x.x が既存のバージョン x.x.x より低い" という警告を抑制します。

• --configfile <FILE>

  使用する NuGet 構成ファイル (nuget.config)。 指定した場合、このファイルの設定のみが使用されます。 指定しない場合、現在のディレクトリからの構成ファイルの階層が使用されます。 詳細については、「一般的な NuGet 構成」をご覧ください。

• --disable-parallel

  複数のプロジェクトを並行して復元できないようにします。

• --framework <FRAMEWORK>

  ツールを更新する ターゲット フレームワーク を指定します。

• -g|--global

  更新プログラムがユーザー全体のツール用であることを指定します。 --tool-path オプションと組み合わせることはできません。 --globalと--tool-pathの両方を省略すると、更新するツールがローカル ツールであることが指定されます。

• -?|-h|--help

  コマンドの使用方法を示した説明を出力します。

• --ignore-failed-sources

  パッケージ ソース エラーを警告として処理します。

• --interactive

  コマンドを停止して、ユーザーの入力または操作のために待機させることができます。 たとえば、認証を完了する場合があります。

• --local

  ツールとローカル ツール マニフェストを更新します。 --global オプションまたは --tool-path オプションと組み合わせることはできません。

• --no-cache

  パッケージと HTTP 要求をキャッシュしないでください。

• --prerelease

  プレリリース バージョンを含めます。

• --tool-manifest <PATH>

  マニフェスト ファイルへのパス。

• --tool-path <PATH>

  グローバル ツールをインストールする場所を指定します。 PATH は絶対パスでも相対パスでもかまいません。 --global オプションと組み合わせることはできません。 --globalと--tool-pathの両方を省略すると、更新するツールがローカル ツールであることが指定されます。

• -v|--verbosity <LEVEL>

  コマンドの詳細レベルを設定します。 指定できる値は、q[uiet]、m[inimal]、n[ormal]、d[etailed]、および diag[nostic] です。 詳細については、LoggerVerbosityを参照してください。

• --version <VERSION>

  更新するツール パッケージのバージョン範囲。 これを使用してバージョンをダウングレードすることはできません。新しいバージョンを最初に uninstall する必要があります。

  .NET 8.0 以降では、 --version Major.Minor.Patch は、一覧に含まれるバージョンを含む特定の major.minor.patch バージョンを指します。 代わりに特定の major.minor バージョンの最新バージョンを取得するには、 --version Major.Minor.*を使用します。

例示

• dotnet tool update -g dotnetsay

  dotnetsay グローバル ツールを更新します。

• dotnet tool update dotnetsay --tool-path c:\global-tools

  特定の Windows ディレクトリにある dotnetsay グローバル ツールを更新します。

• dotnet tool update dotnetsay --tool-path ~/bin

  特定の Linux/macOS ディレクトリにある dotnetsay グローバル ツールを更新します。

• dotnet tool update dotnetsay

  現在のディレクトリにインストールされている dotnetsay ローカル ツールを更新します。

• dotnet tool update -g dotnetsay --version 2.0.*

  dotnetsay グローバル ツールを最新のパッチ バージョンに更新し、メジャー バージョンの2とマイナー バージョンの0で更新します。

• dotnet tool update -g dotnetsay --version (2.0.*,2.1.4)

  dotnetsay グローバル ツールを、指定した範囲内の最小バージョンに更新(> 2.0.0 && < 2.1.4)、バージョン 2.1.0がインストールされます。 セマンティック バージョン管理の範囲の詳細については、「 NuGet パッケージのバージョン範囲」を参照してください。

こちらも参照ください

• .NET ツール
• セマンティック バージョン管理
• チュートリアル: .NET CLI を使って .NET グローバル ツールをインストールして使用する
• チュートリアル: .NET CLI を使って .NET ローカル ツールをインストールして使用する