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

この記事では、Windows に .NET をインストールする方法について説明します。In this article, you'll learn how to install .NET on Windows. .NET は、ランタイムと SDK で構成されています。.NET is made up of the runtime and the SDK. ランタイムは .NET アプリを実行するために使用され、アプリに含まれている場合と含まれていない場合があります。The runtime is used to run a .NET app and may or may not be included with the app. SDK は、.NET アプリとライブラリの作成に使用されます。The SDK is used to create .NET apps and libraries. .NET ランタイムは、常に SDK と共にインストールされます。The .NET runtime is always installed with the SDK.

.NET の最新バージョンは 5.0 です。The latest version of .NET is 5.0.

サポートされているリリースSupported releases

以下の表は、現在サポートされている .NET リリースと、それらがサポートされている Windows のバージョンの一覧です。The following table is a list of currently supported .NET releases and the versions of Windows they're supported on. これらのバージョンは、.NET のバージョンがサポート終了するか、Windows のバージョンの有効期限が切れるまでサポートされます。These versions remain supported until either the version of .NET reaches end-of-support or the version of Windows reaches end-of-life.

Windows 10 のバージョンのサービス終了日は、エディションごとに分かれています。Windows 10 versions end-of-service dates are segmented by edition. 次の表では、HomeProPro EducationPro for Workstations の各エディションだけが考慮されています。Only Home, Pro, Pro Education, and Pro for Workstations editions are considered in the following table. 具体的な詳細については、「Windows ライフサイクルのファクト シート」を確認してください。Check the Windows lifecycle fact sheet for specific details.

ヒント

+ 記号は、最小バージョンを表します。A + symbol represents the minimum version.

オペレーティング システムOperating System .NET Core 2.1.NET Core 2.1 .NET Core 3.1.NET Core 3.1 .NET 5.NET 5
Windows 10 / Windows Server バージョン 20H2Windows 10 / Windows Server, Version 20H2 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10 / Windows Server バージョン 2004Windows 10 / Windows Server, Version 2004 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10 / Windows Server バージョン 1909Windows 10 / Windows Server, Version 1909 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10 / Windows Server バージョン 1903Windows 10 / Windows Server, Version 1903 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10 バージョン 1809Windows 10, Version 1809 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10 バージョン 1803Windows 10, Version 1803 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10 バージョン 1709Windows 10, Version 1709 ✔️✔️ ✔️✔️ ✔️✔️
Windows 10 バージョン 1607Windows 10, Version 1607 ✔️✔️ ✔️✔️ ✔️✔️
Windows 8.1Windows 8.1 ✔️✔️ ✔️✔️ ✔️✔️
Windows 7 SP1 ESUWindows 7 SP1 ESU ✔️✔️ ✔️✔️ ✔️✔️
Windows Server 2019Windows Server 2019
Windows Server 2016Windows Server 2016
Windows Server 2012 R2Windows Server 2012 R2
✔️✔️ ✔️✔️ ✔️✔️
Windows Server Core 2012 R2Windows Server Core 2012 R2 ✔️✔️ ✔️✔️ ✔️✔️
Nano Server バージョン 1809 以上Nano Server, Version 1809+ ✔️✔️ ✔️✔️ ✔️✔️
Nano Server バージョン 1803Nano Server, Version 1803 ✔️✔️ ✔️✔️

サポートされていないリリースUnsupported releases

次のバージョンの .NET は、❌ サポート対象外となりました。The following versions of .NET are ❌ no longer supported:

  • 3.03.0
  • 2.22.2
  • 2.02.0

ランタイムに関する情報Runtime information

ランタイムは、.NET で作成されたアプリを実行するために使用されます。The runtime is used to run apps created with .NET. アプリの作成者は、アプリを公開するとき、アプリにランタイムを含めることができます。When an app author publishes an app, they can include the runtime with their app. ランタイムが含まれていない場合は、ユーザーがランタイムをインストールする必要があります。If they don't include the runtime, it's up to the user to install the runtime.

Windows には、3 つの異なるランタイムをインストールできます。There are three different runtimes you can install on Windows:

  • ASP.NET Core ランタイムASP.NET Core runtime
    ASP.NET Core アプリを実行します。Runs ASP.NET Core apps. .NET ランタイムが含まれます。Includes the .NET runtime.

  • Desktop ランタイムDesktop runtime
    Windows 用の .NET WPF と Windows フォームのデスクトップ アプリを実行します。Runs .NET WPF and Windows Forms desktop apps for Windows. .NET ランタイムが含まれます。Includes the .NET runtime.

  • .NET ランタイム.NET runtime
    このランタイムは最も単純なランタイムであり、他のランタイムは含まれていません。This runtime is the simplest runtime and doesn't include any other runtime. .NET アプリとの互換性を最善にするには、"ASP.NET Core ランタイム" と "Desktop ランタイム" の両方をインストールすることを強くお勧めします。It's highly recommended that you install both ASP.NET Core runtime and Desktop runtime for the best compatibility with .NET apps.

SDK に関する情報SDK information

SDK は、.NET アプリとライブラリを作成して公開するために使用されます。The SDK is used to build and publish .NET apps and libraries. SDK のインストールには、次の 3 つのランタイムが含まれます: ASP.NET Core、Desktop、.NET。Installing the SDK includes all three runtimes: ASP.NET Core, Desktop, and .NET.

依存関係Dependencies

.NET 5.0 では以下の Windows のバージョンがサポートされます。The following Windows versions are supported with .NET 5.0:

注意

+ 記号は、最小バージョンを表します。A + symbol represents the minimum version.

OSOS バージョンVersion アーキテクチャArchitectures
Windows 10 クライアントWindows 10 Client バージョン 1607+Version 1607+ x64、x86、ARM64x64, x86, ARM64
Windows クライアントWindows Client 7 SP1+、8.17 SP1+, 8.1 x64、x86x64, x86
Windows ServerWindows Server 2012 R2+2012 R2+ x64、x86x64, x86
Windows サーバー コアWindows Server Core 2012 R2+2012 R2+ x64、x86x64, x86
Nano ServerNano Server バージョン 1809+Version 1809+ X64x64

.NET 5.0 でサポートされているオペレーティング システム、ディストリビューション、ライフサイクル ポリシーの詳細については、「.NET 5.0 Supported OS Versions」 (.NET 5.0 でサポートされている OS バージョン) を参照してください。For more information about .NET 5.0 supported operating systems, distributions, and lifecycle policy, see .NET 5.0 Supported OS Versions.

Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2Windows 7 / Vista / 8.1 / Server 2008 R2 / Server 2012 R2

次の Windows のバージョンに .NET SDK またはランタイムをインストールする場合は、さらに依存関係が必要になります。More dependencies are required if you're installing the .NET SDK or runtime on the following Windows versions:

オペレーティング システムOperating System 前提条件Prerequisites
Windows 7 SP1 ESUWindows 7 SP1 ESU - Microsoft Visual C++ 2015-2019 再頒布可能パッケージ 64 ビット / 32 ビット- Microsoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
- KB3063858 64 ビット / 32 ビット- KB3063858 64-bit / 32-bit
- Microsoft Root Certificate Authority 2011 (.NET Core 2.1 のオフライン インストーラーのみ)- Microsoft Root Certificate Authority 2011 (.NET Core 2.1 offline installer only)
Windows Vista SP 2Windows Vista SP 2 Microsoft Visual C++ 2015-2019 再頒布可能パッケージ 64 ビット / 32 ビットMicrosoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows 8.1Windows 8.1 Microsoft Visual C++ 2015-2019 再頒布可能パッケージ 64 ビット / 32 ビットMicrosoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows Server 2008 R2Windows Server 2008 R2 Microsoft Visual C++ 2015-2019 再頒布可能パッケージ 64 ビット / 32 ビットMicrosoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit
Windows Server 2012 R2Windows Server 2012 R2 Microsoft Visual C++ 2015-2019 再頒布可能パッケージ 64 ビット / 32 ビットMicrosoft Visual C++ 2015-2019 Redistributable 64-bit / 32-bit

上記の要件は、次のいずれかの dll に関するエラーが発生した場合にも必要です。The previous requirements are also required if you receive an error related to either of the following dlls:

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

PowerShell オートメーションを使用してインストールするInstall with PowerShell automation

dotnet-install スクリプトは、ランタイムの CI 自動化および管理者以外によるインストールに使用されます。The dotnet-install scripts are used for CI automation and non-admin installs of the runtime. スクリプトは、dotnet-install スクリプト参照ページからダウンロードできます。You can download the script from the dotnet-install script reference page.

スクリプトでは、既定で最新の 長期サポート (LTS) バージョン (.NET Core 3.1) がインストールされます。The script defaults to installing the latest long term support (LTS) version, which is .NET Core 3.1. Channel スイッチを指定することで、特定のリリースを選択できます。You can choose a specific release by specifying the Channel switch. ランタイムをインストールするには、Runtime スイッチを含めます。Include the Runtime switch to install a runtime. それ以外の場合は、スクリプトによって SDK がインストールされます。Otherwise, the script installs the SDK.

dotnet-install.ps1 -Channel 5.0 -Runtime aspnetcore

-Runtime スイッチを省略して SDK をインストールします。Install the SDK by omitting the -Runtime switch. この例では、-Channel スイッチが Current に設定されているため、サポートされている最新バージョンがインストールされます。The -Channel switch is set in this example to Current, which installs the latest supported version.

dotnet-install.ps1 -Channel Current

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

次の表で、Visual Studio を使用して .NET アプリを開発している場合に、ターゲットの .NET SDK バージョンに基づいて最低限必要な Visual Studio のバージョンを説明しています。If you're using Visual Studio to develop .NET apps, the following table describes the minimum required version of Visual Studio based on the target .NET SDK version.

.NET SDK バージョン.NET SDK version Visual Studio のバージョンVisual Studio version
5.05.0 Visual Studio 2019 バージョン 16.8 以降。Visual Studio 2019 version 16.8 or higher.
3.13.1 Visual Studio 2019 バージョン 16.4 以降。Visual Studio 2019 version 16.4 or higher.
3.03.0 Visual Studio 2019 バージョン 16.3 以降。Visual Studio 2019 version 16.3 or higher.
2.22.2 Visual Studio 2017 バージョン 15.9 以降。Visual Studio 2017 version 15.9 or higher.
2.12.1 Visual Studio 2017 バージョン 15.7 以降。Visual Studio 2017 version 15.7 or higher.

Visual Studio を既にインストールしてある場合は、次の手順でバージョンを確認できます。If you already have Visual Studio installed, you can check your version with the following steps.

  1. Visual Studio を開きます。Open Visual Studio.
  2. [ヘルプ] > [Microsoft Visual Studio のバージョン情報] を選択します。Select Help > About Microsoft Visual Studio.
  3. [バージョン情報] ダイアログで、バージョン番号を確認します。Read the version number from the About dialog.

Visual Studio には、最新の .NET SDK とランタイムをインストールできます。Visual Studio can install the latest .NET SDK and runtime.

ワークロードを選択するSelect a workload

Visual Studio をインストールまたは変更するときは、ビルドするアプリケーションの種類に応じて、次の 1 つ以上のワークロードを選択します。When installing or modifying Visual Studio, select one or more of the following workloads, depending on the kind of application you're building:

  • [他のツールセット] セクションの [.NET Core クロスプラットフォームの開発] ワークロード。The .NET Core cross-platform development workload in the Other Toolsets section.
  • [Web クラウド] セクションの [ASP.NET と Web 開発] ワークロード。The ASP.NET and web development workload in the Web & Cloud section.
  • [Web クラウド] セクションの [Azure の開発] ワークロード。The Azure development workload in the Web & Cloud section.
  • [デスクトップとモバイル] セクションの [.NET デスクトップ開発] ワークロード。The .NET desktop development workload in the Desktop & Mobile section.

Windows Visual Studio 2019 と .NET Core ワークロードWindows Visual Studio 2019 with .NET Core workload

Visual Studio Code と共にインストールするInstall alongside Visual Studio Code

Visual Studio Code は、デスクトップ上で動作する強力で軽量なソース コード エディターです。Visual Studio Code is a powerful and lightweight source code editor that runs on your desktop. Visual Studio Code は、Windows、macOS、Linux で利用できます。Visual Studio Code is available for Windows, macOS, and Linux.

Visual Studio Code には、Visual Studio のような自動化された .NET Core インストーラーは付属していませんが、.NET Core のサポートを簡単に追加できます。While Visual Studio Code doesn't come with an automated .NET Core installer like Visual Studio does, adding .NET Core support is simple.

  1. Visual Studio Code をダウンロードしてインストールしますDownload and install Visual Studio Code.
  2. .NET Core SDK をダウンロードしてインストールしますDownload and install the .NET Core SDK.
  3. Visual Studio Code マーケットプレースから C# 拡張機能をインストールしますInstall the C# extension from the Visual Studio Code marketplace.

Windows インストーラーWindows Installer

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

Windows インストーラーを使用して .NET をインストールする場合、DOTNETHOME_X64 および DOTNETHOME_X86 パラメーターを設定することによってインストール パスをカスタマイズできます。When you use the Windows installers to install .NET, you can customize the installation path by setting the DOTNETHOME_X64 and DOTNETHOME_X86 parameters:

dotnet-sdk-3.1.301-win-x64.exe DOTNETHOME_X64="F:\dotnet\x64" DOTNETHOME_X86="F:\dotnet\x86"

運用環境で、または継続的インテグレーションをサポートするために .NET をサイレント インストールする場合は、次のスイッチを使用します。If you want to install .NET silently, such as in a production environment or to support continuous integration, use the following switches:

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

  • /quiet
    UI やプロンプトが表示されないようにします。Prevents any UI and prompts from displaying.

  • norestart
    再起動の試行を抑制します。Suppresses any attempts to restart.

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

詳細については、「インストーラーの標準コマンドライン オプション」を参照してください。For more information, see Standard Installer Command-Line Options.

ヒント

成功した場合は、インストーラーから終了コード 0 が返されます。再起動が必要であることを示す場合は、終了コード 3010 が返されます。The installer returns an exit code of 0 for success and an exit code of 3010 to indicate that a restart is required. その他の値は通常、エラー コードです。Any other value is generally an error code.

手動でダウンロードしてインストールするDownload and manually install

.NET 用 Windows インストーラーの代わりに、SDK またはランタイムをダウンロードして手動でインストールすることもできます。As an alternative to the Windows installers for .NET, you can download and manually install the SDK or runtime. 手動インストールは、通常、継続的インテグレーション テストの一環として行われます。Manual install is usually done as part of continuous integration testing. 開発者またはユーザーの場合、通常はインストーラーを使用することをお勧めします。For a developer or user, it's generally better to use an installer.

.NET SDK と .NET ランタイムはどちらも、ダウンロード後に手動でインストールできます。Both .NET SDK and .NET Runtime can be manually installed after they've been downloaded. .NET SDK をインストールする場合、対応するランタイムをインストールする必要はありません。If you install .NET SDK, you don't need to install the corresponding runtime. まず、次のいずれかのサイトから SDK またはランタイムのバイナリ リリースをダウンロードします。First, download a binary release for either the SDK or the runtime from one of the following sites:

.NET を抽出するためのディレクトリを作成します (%USERPROFILE%\dotnet など)。Create a directory to extract .NET to, for example %USERPROFILE%\dotnet. 次に、ダウンロードした zip ファイルをそのディレクトリに抽出します。Then, extract the downloaded zip file into that directory.

既定では、この方法でインストールされた .NET は、.NET CLI コマンドおよびアプリから使用されないため、使用することを明示的に選択する必要があります。By default, .NET CLI commands and apps won't use .NET installed in this way and you must explicitly choose to use it. これを行うには、アプリケーションの起動に使用する環境変数を変更します。To do so, change the environment variables with which an application is started:

set DOTNET_ROOT=%USERPROFILE%\dotnet
set PATH=%USERPROFILE%\dotnet;%PATH%
set DOTNET_MULTILEVEL_LOOKUP=0

この方法では、複数のバージョンを別々の場所にインストールして、その場所を参照する環境変数を使ってアプリケーションを実行することで、アプリケーションによって使用されるインストール場所を明示的に選択できます。This approach lets you install multiple versions into separate locations, then explicitly choose which install location an application should use by running the application with environment variables pointing at that location.

DOTNET_MULTILEVEL_LOOKUP0 に設定されている場合、.NET により、グローバルにインストールされている .NET のバージョンはすべて無視されます。When DOTNET_MULTILEVEL_LOOKUP is set to 0, .NET ignores any globally installed .NET version. アプリケーションを実行するための最適なフレームワークを選択するときに、.NET によりグローバル インストールの既定の場所が考慮されるようにするには、その環境設定を削除します。Remove that environment setting to let .NET consider the default global install location when selecting the best framework for running the application. 通常、既定値は C:\Program Files\dotnet です。インストーラーによってここに .NET がインストールされます。The default is typically C:\Program Files\dotnet, which is where the installers install .NET.

DockerDocker

コンテナーを使用すると、アプリケーションをホスト システムの他の部分から簡単に分離できます。Containers provide a lightweight way to isolate your application from the rest of the host system. 同じコンピューター上のコンテナーでは、カーネルだけが共有され、アプリケーションに提供されたリソースが使用されます。Containers on the same machine share just the kernel and use resources given to your application.

.NET は Docker コンテナー内で実行できます。.NET can run in a Docker container. 公式の .NET Docker イメージは Microsoft Container Registry (MCR) に公開され、Microsoft .NET の Docker Hub リポジトリで見つけられます。Official .NET Docker images are published to the Microsoft Container Registry (MCR) and are discoverable at the Microsoft .NET Docker Hub repository. 各リポジトリには、.NET (SDK またはランタイム) と自分が使用できる OS のさまざまな組み合わせのイメージが含まれています。Each repository contains images for different combinations of the .NET (SDK or Runtime) and OS that you can use.

Microsoft は、特定のシナリオに対応したイメージを用意しています。Microsoft provides images that are tailored for specific scenarios. たとえば、ASP.NET Core リポジトリには、運用環境での ASP.NET Core アプリの実行用にビルドされたイメージが用意されています。For example, the ASP.NET Core repository provides images that are built for running ASP.NET Core apps in production.

Docker コンテナー内で .NET を使用する方法の詳細については、「.NET および Docker の概要」とサンプルページを参照してください。For more information about using .NET in a Docker container, see Introduction to .NET and Docker and Samples.

次のステップNext steps