Windowsに.NETをインストールする

この記事では、Windowsでサポートされている.NETのバージョン、.NETのインストール方法、SDK とランタイムの違いについて説明します。

.NET Framework とは異なり、.NETはWindowsのバージョンに関連付けられません。 Windowsにインストールできる .NET Framework のバージョンは 1 つだけです。 ただし、.NETはスタンドアロンであり、コンピューターの任意の場所にインストールできます。 一部のアプリには、.NETの独自のコピーが含まれている場合があります。

既定では、インストール方法で別のディレクトリが選択されていない限り、.NETはコンピューター上の Program Files\dotnet ディレクトリにインストールされます。

.NETはランタイムと SDK で構成されます。 ランタイムは.NETアプリを実行し、SDK を使用してアプリを作成します。

適切なランタイムを選択する

Windowsには 3 つの異なるランタイムがあり、さまざまな種類のアプリを実行できます。 SDK には 3 つのランタイムがすべて含まれており、ランタイムのインストーラーには追加のランタイムが含まれている場合があります。 次の表では、特定の.NET インストーラーに含まれるランタイムについて説明します。

Windowsですべての.NET アプリを実行できるようにするには、ASP.NET Core ランタイムと .NET デスクトップ ランタイムの両方をインストールします。 ASP.NET Core ランタイムは Web ベースのアプリを実行し、.NET デスクトップ ランタイムは、Windows Presentation Foundation (WPF) やWindows フォーム アプリなどのデスクトップ アプリを実行します。

.NETのインストール方法を選択する

.NETをインストールするにはさまざまな方法があり、一部の製品では独自のバージョンの.NETを管理できます。 独自のバージョンの.NETを管理するソフトウェアを使用して.NETをインストールすると、システム全体で有効になっていない可能性があります。 他のソフトウェアを使用して.NETをインストールする場合の影響を理解していることを確認します。

以下のセクションの一覧を確認した後で選択する方法がわからない場合は、.NET Installer を使用することをお考えです。

開発者

• Visual Studio

  Visual Studio を使用して.NET アプリを開発する場合は、Visual Studio を使用して.NETをインストールします。 Visual Studioは、.NETの独自のコピーを管理します。 このメソッドは、SDK、ランタイム、およびVisual Studioテンプレートをインストールします。

• Visual Studio Code - C# 開発キット

  Visual Studio Code 用にC# Dev Kit 拡張機能をインストールして、.NET アプリを開発します。 拡張機能では、既にインストールされている SDK を使用することも、専用の SDK をインストールすることもできます。

ユーザーと開発者

• .NET Installer

  Windows インストーラー パッケージ (実行する実行可能ファイル) を使用して、.NETをインストールします。 この方法は、SDK とランタイムをインストールできます。 インストールはシステム全体で実行されます。

• Windows パッケージ マネージャー (WinGet)

  WinGet を使用して、コマンド ラインで.NETを管理する場合に.NETをインストールします。 この方法は、SDK とランタイムをインストールできます。 インストールはシステム全体で実行されます。

• PowerShell

  SDK またはランタイムのインストールを自動化できる PowerShell スクリプト。 インストールする.NETのバージョンを選択できます。

サポートされているバージョン

次の表は、現在サポートされている.NETリリースと、サポートされているWindowsのバージョンの一覧です。 これらのバージョンは、.NETのバージョンがサポート終了またはWindowsのバージョンが終了するまでサポート。

Windows 10バージョンのサービス終了日は、エディション別にセグメント化されます。 次の表では、Home、Pro、Pro Education、Pro for Workstations の各エディションだけが考慮されています。 具体的な詳細については、Windowsライフサイクルファクトシートを確認してください。

Windows 7 / 8.1 / Server 2012

Windows 7およびWindows 8.1でサポートされている.NETのバージョンはなくなりました。 最後にサポートされたリリースは .NET 6 で、サポートは 2024 年 11 月 12 日に終了しました。

Windows Server 2012 は、まだサポートされている任意のバージョンの.NETで引き続きサポートされます。

これらの 3 つのバージョンのWindowsはすべて、さらに依存関係をインストールする必要があります。

上記の要件は、次のいずれかの dll に関するエラーが発生した場合にも必要です。

• api-ms-win-crt-runtime-l1-1-0.dll
• api-ms-win-cor-timezone-l1-1-0.dll
• hostfxr.dll

Arm ベースのWindows PC

.NETは、Arm ベースのWindows PC でサポートされています。 次のセクションでは、.NETをインストールするときに考慮する必要がある事項について説明します。

パスの違い

Arm ベースのWindows PC では、すべての Arm64 バージョンの.NETが通常の C:\Program Files\dotnet\ フォルダーにインストールされます。 ただし、.NET SDK の x64 バージョンは、C:\Program Files\dotnet\x64\ フォルダーにインストールされます。

パス変数

.NET SDK の x64 バージョンと Arm64 バージョンの両方がインストールされている場合は、PATH 変数など、.NETをシステム パスに追加する環境変数を変更する必要がある場合があります。 さらに、一部のツールは DOTNET_ROOT 環境変数に依存します。これは、適切な .NET SDK インストール フォルダーを指すために更新する必要もあります。

Visual Studioを使用してインストールする

Visual Studioは、.NETの他のコピーとは別の.NETの独自のコピーをインストールします。 Visual Studioの異なるバージョンは、異なる.NETのバージョンをサポートします。 Visual Studioの最新バージョンでは、常に最新バージョンの.NETがサポートされます。

Visual Studio インストーラーは、Visual Studioをインストールして構成します。 一部のVisual Studioワークロードには、ASP.NETおよびweb開発、.NETマルチプラットフォームアプリUI開発などの.NETが含まれます。 .NETの特定のバージョンは、Individual Components タブを使用してインストールできます。

Visual Studioドキュメントでは、次の方法について説明します。

• Install Visual Studio。
• Visual Studio のワークロードを構成する。

.NETバージョンとVisual Studio

Visual Studioを使用して.NET アプリを開発する場合は、次の表に、ターゲット .NET SDK のバージョンに基づいて、Visual Studioの最低限必要なバージョンについて説明します。

Visual Studioが既にインストールされている場合は、次の手順でバージョンを確認できます。

1. Visual Studioを開きます。
2. Help>About Microsoft Visual Studio を選択します。
3. [バージョン情報] ダイアログで、バージョン番号を確認します。

詳細については、「.NET SDK、MSBuild、および Visual Studio バージョン管理を参照してください。

Visual Studio Codeを使用してインストールする

Visual Studio Codeは、デスクトップで実行される強力で軽量なソース コード エディターです。 Visual Studio Codeは、システムに既にインストールされている SDK を使用できます。

このWinGet 構成ファイルは、最新の .NET SDK、Visual Studio Code、および C# DevKit をインストールします。 既にインストールされている場合、WinGet はその手順をスキップします。

1. ファイルをダウンロードし、ダブルクリックして実行します。
2. 使用許諾契約書を読み、y と入力し、同意を求められたら Enter キーを選択します。
3. タスク バーで点滅するユーザー アカウント制御 (UAC) プロンプトが表示された場合は、インストールを続行します。

さらに、C# Dev Kit 拡張機能がインストールされていない場合は、.NETがインストールされます。

Visual Studio Codeを使用して.NETをインストールする手順については、「 VS Code での C# の概要を参照してください。

.NET インストーラー

.NETのダウンロード ページには、Windowsインストーラーの実行可能ファイルが用意されています。

1. Web ブラウザーを開き、https://に移動します。

2. ダウンロードする.NETのバージョン (10.0 など) を選択します。

3. .NETをダウンロードするためのリンクが含まれている SDK またはランタイム ボックスを見つけます。

4. Installers 列で、Windows 行を見つけて、CPU アーキテクチャのリンクを選択します。 迷う場合は、最も一般的な x64 を選択してください。

   ブラウザーによってインストーラーが自動的にダウンロードされます。

   ヒント

   次の図は SDK を示していますが、ランタイムをダウンロードすることもできます。

   

5. エクスプローラー Windows開き、ファイルがダウンロードされた場所 (Downloads フォルダーに移動します。

6. ファイルをダブルクリックして.NETをインストールします。

   [Windows インストーラー] ダイアログが開きます。

   

7. Install を選択し、指示に従って.NETをインストールします。

.NET CLI の使用方法については、.NET CLI の概要を参照してください。

コマンド ライン オプション

パラメーターを使用して、オプションの一覧を表示します。

運用環境など、.NETサイレント インストールする場合や継続的インテグレーションをサポートする場合は、次のオプションを使用します。

• /install
  .NETをインストールします。

• /quiet
  UI やプロンプトが表示されないようにします。

• /norestart
  再起動の試行を抑制します。

dotnet-sdk-9.0.100-win-x64.exe /install /quiet /norestart

.NETを既にインストールしている場合は、.NET インストーラーを使用してインストールを管理します。 の代わりに、次のいずれかのオプションを使用します。

• /uninstall
  このバージョンの.NETを削除します。

• /repair
  インストールのキー ファイルまたはコンポーネントが破損しているかどうかを確認し、復元します。

Microsoft Update

.NET インストーラー実行可能ファイルは、Windowsで Microsoft Update (MU) を使用してサービスを提供できる独立した製品です。 MU は Windows Update (WU) とは異なり、.NET Framework などのオペレーティング システム コンポーネントのサービスに使用されます。

サポートされているバージョンの.NETのセキュリティとセキュリティ以外の両方の修正プログラムは、複数の配布チャネルを使用して MU を通じて提供されます。 自動更新 (AU) はエンド ユーザーとコンシューマーに関連しますが、Window Server Update Services (WSUS) と Windows Update カタログは IT 管理者に関連します。

.NET インストーラーの実行可能ファイルは、ランタイムや SDK など、さまざまなアーキテクチャとコンポーネントのメジャー リリースとマイナー リリース間でのサイド バイ サイド (SxS) インストールをサポートします。 たとえば、6.0.15 (x64) ランタイムと 6.0.17 (x86) ランタイムの両方をインストールできます。 MU がトリガーされると、両方のインストールに対して最新のインストーラーが提供されます。

更新をブロックする

ほとんどのユーザーは最新の状態を維持することを好みますが、次の表のレジストリ キーを使用して.NET更新をブロックできます。

サーバー OS の自動更新

サーバー オペレーティング システムの更新プログラムは、WSUS および Microsoft Update Catalog でサポートされていますが、AU ではサポートされていません。 サーバー オペレーティング システムは、次のレジストリ キーを使用して AU を介して更新プログラムを受信することを選択できます。

WSUS と更新プログラムの分類

WSUS は、 分類に基づいて特定の更新プログラムを提供するように構成できます。 .NETの更新プログラムは、security または critical として分類されます。 最新の更新プログラムが重大として分類されている場合は、最新のセキュリティ更新プログラムに置き換えられた古いバージョンの.NETがインストールされている場合、古い security 更新プログラムが提供される可能性があります。 これは、オフライン CAB (Wsusscan2.cab) を使用してコンピューターをスキャンする場合にも当てはまります。

以前のバージョンを削除するタイミングを選択する

インストーラーの実行可能ファイルは、以前のインストールを削除する前に、常に新しいコンテンツをインストールします。 以前のランタイムが削除されると、実行中のアプリケーションが中断またはクラッシュする可能性があります。 .NETの更新による影響を最小限に抑えるために、レジストリ キーを使用して以前の.NETインストールを削除するタイミングを指定できます。

• neverは以前のインストールを保持し、以前の.NETインストールを削除するには手動による介入が必要です。
• は、新しいバージョンのインストール後に以前のインストールを削除します。 これは、.NETの既定の動作です。
• は、Administrators グループのメンバーからの次のログオン セッションまで削除を延期します。
• 値は大文字と小文字が区別されず、無効な値は自動的にに設定されます。

削除が延期されると、インストーラーは以前のバージョンをアンインストールするコマンドを RunOnce レジストリ キーに書き込みます。 このコマンドは、Administrators グループのユーザーがマシンにログオンした場合にのみ実行されます。

Windows パッケージ マネージャー (WinGet) を使用してインストールする

winget.exe ツールを使用して、Windows パッケージ マネージャー サービスを使用して.NETをインストールおよび管理できます。 WinGet をインストールして使用する方法の詳細については、「winget ツールを使用したアプリケーションのインストールと管理」を参照してください。

.NET WinGet パッケージは次のとおりです。

• Microsoft.DotNet.Runtime.10— .NET Runtime 10.0
• Microsoft.DotNet.AspNetCore.10— ASP.NET Core Runtime 10.0
• Microsoft.DotNet.DesktopRuntime.10— .NET デスクトップ ランタイム 10.0
• Microsoft.DotNet.SDK.10— .NET SDK 10.0
• Microsoft.DotNet.Runtime.9— .NET Runtime 9.0
• Microsoft.DotNet.AspNetCore.9— ASP.NET Core Runtime 9.0
• Microsoft.DotNet.DesktopRuntime.9 — .NET デスクトップ ランタイム 9.0
• Microsoft.DotNet.SDK.9— .NET SDK 9.0
• Microsoft.DotNet.Runtime.8 — .NET Runtime 8.0
• Microsoft.DotNet.AspNetCore.8— ASP.NET Core Runtime 8.0
• Microsoft.DotNet.DesktopRuntime.8— .NET デスクトップ ランタイム 8.0
• Microsoft.DotNet.SDK.8— .NET SDK 8.0

SDK のインストール

SDK をインストールする場合、対応するランタイムをインストールする必要はありません。

1. WinGet をインストールします。

2. PowerShell、コマンド プロンプトなどのターミナルを開きます。

3. コマンドを実行し、SDK パッケージの名前を渡します。

   winget install Microsoft.DotNet.SDK.10
   

.NET CLI の使用方法については、.NET CLI の概要を参照してください。

ランタイムをインストールする

インストールできるランタイムにはさまざまなものがあります。 各ランタイムに含まれる内容については、「適切なランタイムを選択する」セクションを参照してください。

1. WinGet をインストールします。

2. PowerShell、コマンド プロンプトなどのターミナルを開きます。

3. コマンドを実行し、SDK パッケージの名前を渡します。

   winget install Microsoft.DotNet.DesktopRuntime.10
   winget install Microsoft.DotNet.AspNetCore.10
   

.NET CLI の使用方法については、.NET CLI の概要を参照してください。

バージョンを検索する

コマンドを使用して、インストールするパッケージのさまざまなバージョンを検索します。 たとえば、次のコマンドは、WinGet で使用可能なすべての.NET SDK を検索します。

winget search Microsoft.DotNet.SDK

検索結果は、各パッケージ ID とともに表に出力されます。

Name                            Id                           Version                 Source
--------------------------------------------------------------------------------------------
Microsoft .NET SDK 3.1          Microsoft.DotNet.SDK.3_1     3.1.426                 winget
Microsoft .NET SDK 5.0          Microsoft.DotNet.SDK.5       5.0.408                 winget
Microsoft .NET SDK 6.0          Microsoft.DotNet.SDK.6       6.0.428                 winget
Microsoft .NET SDK 7.0          Microsoft.DotNet.SDK.7       7.0.410                 winget
Microsoft .NET SDK 8.0          Microsoft.DotNet.SDK.8       8.0.415                 winget
Microsoft .NET SDK 9.0          Microsoft.DotNet.SDK.9       9.0.306                 winget
Microsoft .NET SDK 10.0         Microsoft.DotNet.SDK.10      10.0.100                winget

プレビュー バージョンをインストールする

プレビュー バージョンが使用可能な場合は、 Id のバージョン番号を という単語に置き換えます。 次の例では、.NET デスクトップ ランタイムのプレビュー リリースをインストールします。

winget install Microsoft.DotNet.DesktopRuntime.Preview

PowerShell を使用したインストール

継続的インテグレーションと非管理者インストールでは、dotnet-install PowerShell スクリプトを使用して.NETをインストールすることをお勧めします。 システムで通常使用するために.NETをインストールする場合は、.NET Installer または Windows パッケージ マネージャー インストール方法を使用します。

このスクリプトは、既定で最新の long term support (LTS) バージョン (.NET 10) をインストールします。 スイッチを指定することで、特定のリリースを選択できます。 ランタイムをインストールするには、 スイッチを含めます。 それ以外の場合は、スクリプトによって SDK がインストールされます。 スクリプトは https://dot.net/v1/dotnet-install.ps1 で使用でき、ソース コードは GitHub でホストされます。

スクリプトの詳細については、「-install script reference」を参照してください。

ランタイムをインストールする

.NET ランタイムは、-Runtime スイッチを提供することによってインストールされます。

1. からインストール スクリプトをダウンロードします。

2. PowerShell を開き、スクリプトが含まれているフォルダーに移動します。

3. 次のコマンドを実行して、デスクトップ ランタイムと ASP.NET Core ランタイムの両方をインストールし、互換性を最大限に高めます。

   dotnet-install.ps1 -Runtime windowsdesktop
   dotnet-install.ps1 -Runtime aspnetcore
   

.NET CLI の使用方法については、.NET CLI の概要を参照してください。

SDK のインストール

SDK をインストールする場合、ランタイムをインストールする必要はありません。

1. からインストール スクリプトをダウンロードします。

2. PowerShell を開き、スクリプトが含まれているフォルダーに移動します。

3. 次のコマンドを実行して、.NET SDK をインストールします。

   dotnet-install.ps1
   

   メモ

   スイッチを省略することで、SDK がインストールされます。

.NET CLI の使用方法については、.NET CLI の概要を参照してください。

検証

インストーラーまたはバイナリ リリースをダウンロードした後、ファイルを検証して、変更されたり破損したりしていないことを確認します。 コンピューターでチェックサムを検証し、ダウンロード Web サイトで報告されていたものと比較できます。

公式ダウンロード ページからファイルをダウンロードするときに、ファイルのチェックサムがテキスト ボックスに表示されます。 [コピー] ボタンを選択すると、クリップボードにチェックサム値がコピーされます。

PowerShell またはコマンド プロンプトを使用して、ダウンロードしたファイルのチェックサムを検証できます。 たとえば、次のコマンドは、-sdk-9.0.306-win-x64.exe ファイルのチェックサムを報告します。

> certutil -hashfile dotnet-sdk-9.0.306-win-x64.exe SHA512
SHA512 hash of dotnet-sdk-9.0.306-win-x64.exe:
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f
CertUtil: -hashfile command completed successfully.

> (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash
f048ddf80c0aa88e713070e66a0009435ad9a5f444adbde6edf2b17f8da562d494a5c37cbabaf63ee3125fe1d2da735a397de9a38dd6ca638b8dc085adc01d4f

このチェックサムとダウンロード サイトで提供された値を比較します。

PowerShell とチェックサム ファイルを使用して検証する

.NETリリース ノートには、ダウンロードしたファイルの検証に使用できるチェックサム ファイルへのリンクが含まれています。 次の手順では、チェックサム ファイルをダウンロードしてから、インストールされた.NETバイナリを検証する方法について説明します。

1. https://github.com/dotnet/core/tree/main/release-notes/9.0 のGitHubの.NET 9 のリリース ノート ページには、Releases という名前のセクションが含まれています。 このセクションの表は、各.NET 9 リリースのダウンロード ファイルとチェックサム ファイルにリンクしています。 次の図は、.NET 8 リリース テーブルを参照として示しています。

   GitHub リリース ノートの .NET バージョン テーブル

2. ダウンロードした.NETのバージョンのリンクを選択します。 前のセクションでは、.NET 9.0.10 リリースの SDK 9.0.306 .NET使用しました。

   ヒント

   チェックサム ファイルが含まれている.NETリリースがわからない場合は、見つかるまでリンクを調べます。

3. リリース ページでは、.NET ランタイムと .NET SDK のバージョン、およびチェックサム ファイルへのリンクを確認できます。 次の図は、.NET 8 リリース テーブルを参照として示しています。

   .NET のチェックサム付きダウンロードテーブル

4. チェックサム ファイルへのリンクをコピーします。

5. 次のスクリプトを使用しますが、リンクを置き換えて適切なチェックサム ファイルをダウンロードします。

   Invoke-WebRequest https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt -OutFile 9.0.10-sha.txt
   

6. チェックサム ファイルと.NETリリース ファイルの両方を同じディレクトリにダウンロードした状態で、チェックサム ファイルで.NETダウンロードのチェックサムを検索します。

   検証に合格すると、True が出力されます。

   > (Get-Content .\9.0.10-sha.txt | Select-String "dotnet-sdk-9.0.306-win-x64.exe").Line -like (Get-FileHash .\dotnet-sdk-9.0.306-win-x64.exe -Algorithm SHA512).Hash + "*"
   True
   

   False が出力された場合、ダウンロードしたファイルは無効であり、使用しないでください。

トラブルシューティング

.NET SDK をインストールした後、.NET CLI コマンドを実行しようとすると問題が発生する可能性があります。 このセクションにはそのような一般的な問題がまとめてあり、それらの解決策を提供します。

• .NET SDK が見つかりませんでした
• アプリのビルドが予想よりも遅い
• が見つからない

.NET SDK が見つかりませんでした

ほとんどの場合、.NET SDK の x86 (32 ビット) バージョンと x64 (64 ビット) バージョンの両方をインストールしました。 これにより、 コマンドを実行すると、x64 バージョンで解決されるべきところが x86 バージョンで解決されてしまうため、競合が発生します。 この問題は、x64 バージョンを最初に解決するように 変数を調整することによって修正されます。

1. コマンドを実行して、両方のバージョンがインストールされていることを確認します。 その場合は、\ と (x86)\ フォルダーの両方のエントリが表示されます。 次の例に示すように、 (x86)\ フォルダーが最初にある場合は、正しくなっていないため、次の手順に進む必要があります。

   > where.exe dotnet
   C:\Program Files (x86)\dotnet\dotnet.exe
   C:\Program Files\dotnet\dotnet.exe
   

   ヒント

   この例では が使用されていますが、.exe の他のコピーが一覧表示される場合があります。 適切な .exe が最初に解決されるように調整します。

   正しい場合、Program Files\ が最初にある場合は、このセクションで説明している問題はありません。.NET ヘルプリクエストの問題をGitHubに作成すべきです。

2. Windowsボタンを押し、「システム環境変数を編集する」と入力して検索します。 [システム環境変数の編集] を選びます。

   

3. [システムのプロパティ] ウィンドウの [詳細設定] タブが表示されます。[環境変数] を選びます。

   

4. [環境変数] ウィンドウの [システム変数] グループで、Path* の行を選び、[編集] ボタンを選びます。

   ユーザーとシステム変数を示す [環境変数] ウィンドウ

5. 上へ移動 と 下へ移動 ボタンを使用して、C:\\\ エントリを C:\ (x86)\\ の上に移動します。

   システムの [環境変数] 一覧

アプリのビルドが予想よりも遅い

Windows機能である Smart App Control がオフになっていることを確認します。 開発に使用するマシンで Smart App Control を有効にすることは推奨されません。 [オフ] 以外の設定はすべて、SDK パフォーマンスに悪影響を与える可能性があります。

が欠落しています

Microsoft Visual C++ 2015-2019 再頒布可能パッケージ (64 ビットまたは 32 ビット) をインストールします。

関連するコンテンツ

• .NET CLI の概要
• 新しい.NETバージョンにアップグレード。
• .NETが既にインストールされているかどうかを確認する方法。
• チュートリアル: 新しいコンソール アプリケーションを作成します。