dotnetupとは
dotnetup は、2026年10月15日にパブリックプレビューとして公開された、.NET SDK／ランタイムを管理する新しい公式ツールです。
.NET 10 と .NET 11 Preview などを複数インストールして管理できます。
本記事は、下記のバージョンを対象としています。
dotnetup --version
0.3.0-preview.1.26511.1+ea84ffbcebadd4653918c4ee0874a23001182874
インストール
Windowsの場合、 PowerShell で、下記のコマンドを実行してインストールします。
irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex
インストール後、表示された指示に従って dotnetup の配置先を PATH に追加します。
初期設定
新しい PowerShell を開きます。
dotnetup init
CUIが開きます。
| 項目 | 説明 |
|---|---|
| SDK Channel | インストールする .NET のバージョンと、その更新方法を決定します — 「latest」、「lts」、「preview」、「daily」、または「10.0」のようなバージョン。 |
| Access mode | システムの PATH を変更し、すべてのアプリが dotnetup の .NET インストールを使用するようにします（管理者権限が必要です）。 |
| Migrate system installs | すでにシステム全体にインストールされている SDK およびランタイムのバージョンをインストールし、それらのバージョンが引き続き利用可能になるようにします。 |
ひとまず
SDK Channel : latest
Access mode : None
Migrate system installs : No
で
Accept and install を選択してインストールを実行します。
インストールされた内容の確認
SDK
すでにOSにインストールしていたものと、
dotnetup でインストールしたものが違うとわかります。
PS C:\Users\Kashin777> dotnet --list-sdks
6.0.407 [C:\Program Files\dotnet\sdk]
10.0.402 [C:\Program Files\dotnet\sdk]
PS C:\Users\Kashin777> dotnetup dotnet --list-sdks
6.0.407 [C:\Users\Kashin777\AppData\Local\dotnetup\dotnet\sdk]
9.0.319 [C:\Users\Kashin777\AppData\Local\dotnetup\dotnet\sdk]
10.0.402 [C:\Users\Kashin777\AppData\Local\dotnetup\dotnet\sdk]
11.0.100-rc.2.26504.105 [C:\Users\Kashin777\AppData\Local\dotnetup\dotnet\sdk]
※11 previewは下記のコマンドで別途追加しました。
dotnetup sdk install preview
Runtime
dotnet --list-runtimes
dotnetup dotnet --list-runtimes
dotnetup のSDKを利用したい
コマンドから利用
コマンドの先頭を、dotnetup dotnet に変えるだけです。
dotnetup dotnet build
dotnetupを付けずに利用したい
既存スクリプトなど、 dotnetup を付けずにコマンドから実行したい場合があります。
dotnet コマンドからdotnetupのSDKを利用できるようにする
再度、
dotnetup init
して、
Access mode を Everywhere に変更します。
新しい PowerShell を開いて、dotnet コマンドを確認すると、dotnetup 側の内容が表示されます。
PS C:\Users\Kashin777> dotnet --list-sdks
6.0.407 [C:\Users\Kashin777\AppData\Local\dotnetup\dotnet\sdk]
9.0.319 [C:\Users\Kashin777\AppData\Local\dotnetup\dotnet\sdk]
10.0.402 [C:\Users\Kashin777\AppData\Local\dotnetup\dotnet\sdk]
11.0.100-rc.2.26504.105 [C:\Users\Kashin777\AppData\Local\dotnetup\dotnet\sdk]
Visual Studio / VS Code で利用
dotnetupを付けずに利用したい を実施してください。
あとはソリューション毎に global.json で、利用したいSDKのバージョンを設定します。
json global.json
{
"sdk": {
"version": "11.0.100-rc.2.26504.105",
"rollForward": "disable",
"allowPrerelease": true
}
}