チュートリアル: .NET CLI を使用して .NET グローバルツールをインストールして使用する

この記事は、.NET 8 SDK 以降のバージョンに適用されます: ✔️

このチュートリアルでは、グローバルツールをインストールして使用する方法について説明します。使用するツールは、このシリーズの最初のチュートリアルで作成するツールです。

[前提条件]

このシリーズの最初のチュートリアルを完了します。
.NET 10.0.100 SDK 以降 ( dnxの場合) - 省略可能ですが、推奨されます。

インストールなしでツールを実行する (推奨)

.NET 10.0.100 以降では、 dnxを使用して、永続的なインストールなしで .NET ツールを実行できます。

dnx (簡略化された構文) を使用してツールを直接実行します。
```
dnx dotnet-env --add-source ./nupkg
```
--add-source パラメーターは、ツールが NuGet.org で使用できない場合に nuGet パッケージの追加ソースフィードとして ./nupkg ディレクトリを使用するように.NET CLI に指示します。

ツールをグローバルツールとして使用する (従来のインストール)

頻繁に使用するために永続的なインストールを使用する場合:

dotnet-env プロジェクトフォルダーで dotnet tool install コマンドを実行して、パッケージからツールをインストールします。
```
dotnet tool install --global --add-source ./nupkg dotnet-env
```
--global パラメーターは、PATH 環境変数に自動的に追加される既定の場所にツールバイナリをインストールするように、.NET CLI に指示します。

--add-source パラメーターは、.NET CLI に対して、NuGet パッケージの追加のソースフィードとして ./nupkg ディレクトリを一時的に使用するように指示します。パッケージに一意の名前を付けて、NuGet.org ではなく 、./nupkg ディレクトリにのみ見つかるようにしました。

出力には、ツールの呼び出しに使用したコマンドと、インストールされているバージョンが表示されます。
```
You can invoke the tool using the following command: dotnet-env
Tool 'dotnet-env' (version '1.0.0') was successfully installed.
```
注

既定では、インストールする .NET バイナリのアーキテクチャは、現在実行中の OS アーキテクチャを表します。別の OS アーキテクチャを指定するには、 dotnet ツールのインストール、--arch オプションを参照してください。
ツールを呼び出します。
```
dotnet-env
```
注

コマンドが失敗した場合は、新しいターミナルを開き、 PATH 環境変数を更新します。
dotnet ツールのアンインストールコマンドを実行して、ツールを削除します。
```
dotnet tool uninstall -g dotnet-env
```

カスタムの場所にインストールされているグローバルツールとしてツールを使用する

パッケージからツールをインストールします。

Windows の場合:
```
dotnet tool install --tool-path c:\dotnet-tools --add-source ./nupkg dotnet-env
```
Linux または macOS の場合:
```
dotnet tool install --tool-path ~/bin --add-source ./nupkg dotnet-env
```
--tool-path パラメーターは、指定した場所にツールバイナリをインストールするように .NET CLI に指示します。ディレクトリが存在しない場合は、作成されます。ディレクトリは、 PATH 環境変数に自動的に追加されません。

出力には、ツールの呼び出しに使用したコマンドと、インストールされているバージョンが表示されます。
```
You can invoke the tool using the following command: dotnet-env
Tool 'dotnet-env' (version '1.0.0') was successfully installed.
```
ツールを呼び出します。

Windows の場合:
```
c:\dotnet-tools\dotnet-env
```
Linux または macOS の場合:
```
~/bin/dotnet-env
```
dotnet ツールのアンインストールコマンドを実行して、ツールを削除します。

Windows の場合:
```
dotnet tool uninstall --tool-path c:\dotnet-tools dotnet-env
```
Linux または macOS の場合:
```
dotnet tool uninstall --tool-path ~/bin dotnet-env
```

Troubleshoot

チュートリアルの実行中にエラーメッセージが表示される場合は、「 .NET ツールの使用に関する問題のトラブルシューティング」を参照してください。

次のステップ

このチュートリアルでは、ツールをグローバルツールとしてインストールして使用しました。グローバルツールのインストールと使用の詳細については、「グローバルツールの管理」を参照してください。ローカルツールと同じツールをインストールして使用するには、次のチュートリアルに進みます。

ローカルツールをインストールして使用する

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-04-24

チュートリアル: .NET CLI を使用して .NET グローバル ツールをインストールして使用する