dotnet tool update

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

名前

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

構文

dotnet tool update <PACKAGE_ID> -g|--global
    [--add-source <SOURCE>] [--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>] [--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>] [--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 tool list コマンドを使用できます。

[オプション]

• --add-source <SOURCE>

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

• --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)

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

関連項目

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