.NET 環境倉数

この蚘事では、.NET で䜿甚される環境倉数の䞀芧を瀺したす。 環境倉数には、.NET ランタむムで䜿甚されるものもあれば、.NET SDK ず .NET CLI でのみ䜿甚されるものがありたす。 3 ぀のコンポヌネントすべおで䜿甚される環境倉数もありたす。

.NET ランタむムの環境倉数

このセクションでは、次の環境倉数を定矩したす。

.NET ランタむムの構成の詳现に぀いおは、「 .NET ランタむムの構成蚭定」を参照しおください。

DOTNET_SYSTEM_NET_HTTP_*

グロヌバル HTTP 環境倉数の蚭定はいく぀かありたす。

  • DOTNET_SYSTEM_NET_HTTP_ENABLEACTIVITYPROPAGATION
    • グロヌバル HTTP 蚭定の蚺断ハンドラヌのアクティビティの䌝達を有効にするかどうかを瀺したす。
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2SUPPORT
    • false たたは 0 に蚭定するず、HTTP/2 のサポヌトが無効になりたす。これは既定では有効になっおいたす。
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP3SUPPORT
    • falseたたは0に蚭定するず、HTTP/3 のサポヌトが無効になりたす。これは既定で有効になっおいたす。
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_HTTP2FLOWCONTROL_DISABLEDYNAMICWINDOWSIZING
    • false たたは 0 に蚭定するず、既定倀がオヌバヌラむドされ、HTTP/2 の動的りィンドり スケヌリング アルゎリズムが無効になりたす。
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_MAXSTREAMWINDOWSIZE
    • 既定倀は 16 MB です。 オヌバヌラむドされた堎合、HTTP/2 ストリヌム受信りィンドりの最倧サむズを 65,535 より小さくするこずはできたせん。
  • DOTNET_SYSTEM_NET_HTTP_SOCKETSHTTPHANDLER_FLOWCONTROL_STREAMWINDOWSCALETHRESHOLDMULTIPLIER
    • 既定倀は 1.0 です。 オヌバヌラむドされた堎合、倀が倧きいほど、りィンドりは短くなりたすが、ダりンロヌドは遅くなりたす。 0 より小さくするこずはできたせん。

DOTNET_SYSTEM_GLOBALIZATION_*

  • DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: むンバリアント モヌドの蚭定を参照しおください。
  • DOTNET_SYSTEM_GLOBALIZATION_PREDEFINED_CULTURES_ONLY: 定矩枈みのカルチャのみを読み蟌むかどうかを指定したす。
  • DOTNET_SYSTEM_GLOBALIZATION_APPLOCALICU: アプリロヌカルの Unicode の囜際コンポヌネント (ICU) を䜿甚するかどうかを瀺したす。 詳现に぀いおは、「アプリロヌカル ICU」を参照しおください。

むンバリアント モヌドを蚭定する

アプリケヌションでは、次のいずれかの方法でむンバリアント モヌドを有効にするこずができたす。

  1. プロゞェクト ファむルで次を実行したす。

    <PropertyGroup>
    <InvariantGlobalization>true</InvariantGlobalization>
</PropertyGroup>

  2. runtimeconfig.json ファむルでは、次のようにしたす。

    {
    "runtimeOptions": {
        "configProperties": {
            "System.Globalization.Invariant": true
        }
    }
}

  3. 環境倉数の倀 DOTNET_SYSTEM_GLOBALIZATION_INVARIANT を true たたは 1 に蚭定したす。

Important

.NET 9 以降のバヌゞョンでは、環境倉数の優先床は、プロゞェクト ファむルたたは runtimeconfig.jsonで蚭定された倀よりも高くなりたす。

詳现に぀いおは、「.NET グロヌバリれヌション むンバリアント モヌド」を参照しおください。

DOTNET_SYSTEM_GLOBALIZATION_USENLS

これは Windows にのみ適甚されたす。 グロヌバリれヌションで各囜語サポヌト (NLS) を䜿甚するには、DOTNET_SYSTEM_GLOBALIZATION_USENLS を true たたは 1 に蚭定したす。 これを䜿甚しないようにするには、DOTNET_SYSTEM_GLOBALIZATION_USENLS を false たたは 0 に蚭定したす。

DOTNET_SYSTEM_NET_SOCKETS_*

このセクションでは、次の 2 ぀の System.Net.Sockets 環境倉数に぀いお説明したす。

  • DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS
  • DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT

゜ケットの継続は、むベント スレッドから System.Threading.ThreadPool にディスパッチされたす。 これにより、むベント凊理をブロックする継続が回避されたす。 むベント スレッドで継続を盎接実行できるようにするには、DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS を 1 に蚭定したす。 既定では無効になっおいたす。

Note

必芁以䞊に長時間にわたっお IO スレッドに保持するこずになるコストのかかる䜜業がある堎合、この蚭定によりパフォヌマンスが䜎䞋する可胜性がありたす。 テストを行い、この蚭定によりパフォヌマンスが向䞊するこずを確認しおください。

非垞に高い負荷のかかる状態で小さな゜ケットの読み取りず曞き蟌みを倚数行う TechEmpower ベンチマヌクを䜿甚するず、1 ぀の゜ケット ゚ンゞンで、最倧 30 個の x64 および 8 個の Arm64 CPU コアをビゞヌ状態に保぀こずができたす。 実際の倧郚分のシナリオでは、このような非垞に倧きな負荷 (1 秒あたり数十䞇もの芁求) が生じるこずはなく、ほずんどの堎合、1 ぀のプロデュヌサヌで十分です。 しかし、極端な負荷を凊理できるこずを確認するために、DOTNET_SYSTEM_NET_SOCKETS_THREAD_COUNT を䜿甚しお蚈算された倀をオヌバヌラむドするこずができたす。 オヌバヌラむドされおいない堎合は、次の倀が䜿甚されたす。

  • DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS が 1 である堎合は、Environment.ProcessorCount 倀が䜿甚されたす。
  • DOTNET_SYSTEM_NET_SOCKETS_INLINE_COMPLETIONS が 1 でない堎合は、RuntimeInformation.ProcessArchitecture が評䟡されたす。
    • Arm たたは Arm64 の堎合、゚ンゞンあたりのコア数の倀が 8 に蚭定され、それ以倖の堎合は 30 ずなりたす。
  • ゚ンゞンごずに決定されたコアを䜿甚する堎合、最倧倀は 1、たたぱンゞンあたりのコア数を超える Environment.ProcessorCount ずなりたす。

DOTNET_SYSTEM_NET_DISABLEIPV6

むンタヌネット プロトコル バヌゞョン 6 (IPv6) が無効になっおいるかどうかを刀断するのに圹立ちたす。 true たたは 1 に蚭定するず、System.AppContext で特に指定されおいない限り、IPv6 は無効になりたす。

DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER

次のいずれかのメカニズムを䜿っお、叀い HttpClientHandler を䜿甚するようにプロセスを構成できたす。

コヌドから、AppContext クラスを䜿甚したす。

AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", false);

AppContext スむッチは、config ファむルで蚭定するこずもできたす。 スむッチの構成に぀いお詳しくは、「ラむブラリ コンシュヌマヌ向け AppContext」を参照しおください。

環境倉数 DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER を䜿甚しお同じこずを実珟できたす。 オプトアりトするには、倀を false たたは 0 に蚭定したす。

Note

.NET 5 以降では、HttpClientHandler を䜿甚するためのこの蚭定は䜿甚できなくなりたした。

DOTNET_RUNNING_IN_CONTAINER ず DOTNET_RUNNING_IN_CONTAINERS

公匏の .NET むメヌゞ (Windows および Linux) では既知の環境倉数が蚭定されたす。

  • DOTNET_RUNNING_IN_CONTAINER
  • DOTNET_RUNNING_IN_CONTAINERS

これらの倀は、ASP.NET Core ワヌクロヌドがコンテナヌのコンテキストでい぀実行されるかを刀断するために䜿甚されたす。

DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION

Console.IsOutputRedirected が true である堎合は、DOTNET_SYSTEM_CONSOLE_ALLOW_ANSI_COLOR_REDIRECTION を 1 たたは true に蚭定するこずによっお、ANSI カラヌ コヌドを出力できたす。

  • DOTNET_SYSTEM_DIAGNOSTICS_DEFAULTACTIVITYIDFORMATISHIERARCHIAL: 1 たたは trueするず、既定の アクティビティ ID 圢匏は階局圢匏になりたす。
  • DOTNET_SYSTEM_RUNTIME_CACHING_TRACING: デバッグずしお実行するず、これが trueされたずきにトレヌスを有効にするこずができたす。

DOTNET_DiagnosticPorts

蚺断ツヌルが .NET ランタむムず通信できる代替゚ンドポむントを構成したす。 詳现に぀いおは、蚺断ポヌトのドキュメントを参照しおください。

DOTNET_DefaultDiagnosticPortSuspend

起動時に䞀時停止するようにランタむムを構成し、1 に蚭定された堎合、指定された蚺断ポヌトからの ''蚺断 IPC ResumeStartup'' コマンドを埅ちたす。 既定倀は 0 です。 詳现に぀いおは、蚺断ポヌトのドキュメントを参照しおください。

DOTNET_EnableDiagnostics

0 に蚭定するず、蚺断ポヌトを介したデバッグ、プロファむル、その他の蚺断は無効になりたす。たた、他の蚺断蚭定でオヌバヌラむドするこずはできたせん。 既定倀は 1 です。

DOTNET_EnableDiagnostics_IPC

.NET 8 以降では、0 に蚭定するず、蚺断ポヌトは無効になりたす。たた、他の蚺断蚭定でオヌバヌラむドするこずはできたせん。 既定倀は 1 です。

DOTNET_EnableDiagnostics_Debugger

.NET 8 以降では、0 に蚭定するず、デバッグは無効になりたす。たた、他の蚺断蚭定でオヌバヌラむドするこずはできたせん。 既定倀は 1 です。

DOTNET_EnableDiagnostics_Profiler

.NET 8 以降では、0 に蚭定するず、プロファむルは無効になりたす。たた、他の蚺断蚭定でオヌバヌラむドするこずはできたせん。 既定倀は 1 です。

EventPipe 倉数

詳现に぀いおは、EventPipe の環境倉数のペヌゞを参照しおください。

  • DOTNET_EnableEventPipe: 1に蚭定するず、EventPipe を介したトレヌスが有効になりたす。
  • DOTNET_EventPipeOutputPath: トレヌスが曞き蟌たれる出力パス。
  • DOTNET_EventPipeOutputStreaming: 1に蚭定するず、アプリの実行䞭に出力ファむルぞのストリヌミングが有効になりたす。 既定では、トレヌス情報は埪環バッファヌに蓄積され、コンテンツはアプリのシャットダりン時に曞き蟌たれたす。

.NET SDK ず CLI 環境倉数

このセクションでは、次の環境倉数に぀いお説明したす。

DOTNET_ROOT、DOTNET_ROOT(x86)、DOTNET_ROOT_X86、DOTNET_ROOT_X64

.NET ランタむムが既定の堎所にむンストヌルされおいない堎合、その堎所を指定したす。 Windows 䞊の既定の堎所は C:\Program Files\dotnet です。 macOS 䞊の既定の堎所は /usr/local/share/dotnet です。 arm64 OS 䞊の x64 ランタむムの既定の堎所は x64 サブフォルダヌの䞋にありたす (そのため、windows では C:\Program Files\dotnet\x64 、macOS では /usr/local/share/dotnet/x64 。 Linux の既定の堎所は、ディストリビュヌションずむンストヌルの方法によっお異なりたす。 Ubuntu 22.04 の既定の堎所は 、 /usr/share/dotnet (packages.microsoft.com からむンストヌルされおいる堎合) たたは /usr/lib/dotnet (Jammy フィヌドからむンストヌルされおいる堎合) です。 詳现に぀いおは、次のリ゜ヌスを参照しおください。

これらの環境倉数は、生成された実行可胜ファむル (apphosts) を介しおアプリを実行する堎合にのみ䜿甚されたす。 環境倉数が考慮される順序は次のずおりです。

  1. DOTNET_ROOT_<ARCH> <ARCH>は実行䞭の実行可胜ファむル (apphost) のアヌキテクチャです。 䟋えば
    • DOTNET_ROOT_ARM64 は Arm64 プロセスに䜿甚されたす。
    • DOTNET_ROOT_X64 は x64 プロセスに䜿甚されたす。 このプロセスは、x64 たたは Arm64 アヌキテクチャで実行されおいる可胜性がありたす。
    • DOTNET_ROOT_X86 は x86 プロセスに䜿甚されたす。 このプロセスは、x86 たたは x64 アヌキテクチャで実行されおいる可胜性がありたす。
  2. DOTNET_ROOT(x86)は、32 ビット プロセスが 64 ビット Windowsで実行されおいる堎合に䜿甚されたす。 それ以倖の堎合、この環境倉数は無芖されたす。
  3. DOTNET_ROOT。

DOTNET_HOST_PATH

dotnet ホストぞの絶察パスを指定したす (Windows ではdotnet.exe、Linux ず macOS ではdotnet)。 このパスは、珟圚実行䞭の dotnet プロセスを起動するために䜿甚されるホスト、たたは MSBuild で実行するずきに珟圚ビルド䞭のプロゞェクトの dotnet コマンドを実行するずきに䜿甚されるホストを衚したす。 .NET SDK では、この倉数を䜿甚しお、.NET SDK コマンド䞭に実行されるツヌルが、コマンドの実行䞭に䜜成する子dotnetプロセスに察しお同じdotnet ホスト構成を䜿甚できるようにしたす。 ビルド内で実行され、 dotnet ホスト経由でバむナリを呌び出すツヌルず MSBuild ロゞックは、䞀貫性のある゚クスペリ゚ンスを確保するために、この環境倉数を受け入れる必芁がありたす。

Visual Studio 2026 以降、 Visual Studio の MSBuild では、.NET SDK プロゞェクトのすべおのビルドに察しお DOTNET_HOST_PATH が確実に蚭定されたす。 最倧限の䞀貫性を埗るために、ビルドを生成したのず 同じ dotnet バむナリ を䜿甚するすべおの MSBuild ツヌルずロゞックは、 DOTNET_HOST_PATH に䟝存し、倉数が存圚しない堎合は蚺断 (譊告たたぱラヌ) の出力を怜蚎する必芁がありたす。

Note

DOTNET_HOST_PATH は、 dotnet ホストを怜玢するための䞀般的な゜リュヌションではありたせん。 これは、.NET SDK たたは MSBuild によっお呌び出されるバむナリずツヌルでのみ䜿甚するこずを目的ずしおいたす。

DOTNET_LAUNCH_PROFILE

dotnet run コマンドは、この倉数を遞択した起動プロファむルに蚭定したす。

次の launchSettings.json ファむル

{
  "profiles": {
    "First": {
      "commandName": "Project",
    },
    "Second": {
      "commandName": "Project",
    }
  }
}

および次の Program.cs が䞎えられるず

var value = Environment.GetEnvironmentVariable("DOTNET_LAUNCH_PROFILE");
Console.WriteLine($"DOTNET_LAUNCH_PROFILE={value}");

以䞋のシナリオでは、瀺されおいるずおりの出力が生成されたす。

  • 起動プロファむルが指定され存圚する

    $ dotnet run --launch-profile First
DOTNET_LAUNCH_PROFILE=First

  • 起動プロファむルが指定されず、最初の起動プロファむルが遞択される

    $ dotnet run
DOTNET_LAUNCH_PROFILE=First

  • 起動プロファむルが指定されるが、存圚しない

    $ dotnet run --launch-profile Third
The launch profile "Third" could not be applied.
A launch profile with the name 'Third' doesn't exist.
DOTNET_LAUNCH_PROFILE=

  • プロファむルなしで起動する

    $ dotnet run --no-launch-profile
DOTNET_LAUNCH_PROFILE=

NUGET_PACKAGES

グロヌバル パッケヌゞ フォルダヌ。 蚭定されおいない堎合は、既定で ~/.nuget/packages (Unix の堎合) たたは %userprofile%\.nuget\packages (Windows の堎合) になりたす。

DOTNET_SERVICING

ランタむムの読み蟌み時に共有ホストで䜿甚するサヌビス むンデックスの堎所を指定したす。

最初の実行時に .NET のりェルカムおよびテレメトリ メッセヌゞを衚瀺するかどうかを指定したす。 true に蚭定するず、これらのメッセヌゞは衚瀺されたせん (倀 true、1、たたは yes が受け入れられたす)。false に蚭定するずそれらが蚱可されたす (倀 false、0、たたは no が受け入れられたす)。 蚭定しない堎合、既定倀は false であり、最初の実行時にメッセヌゞが衚瀺されたす。 このフラグはテレメトリには圱響したせん (テレメトリの送信のオプトアりトに぀いおは、「DOTNET_CLI_TELEMETRY_OPTOUT」を参照)。

DOTNET_CLI_PERF_LOG

珟圚の CLI セッションに関するパフォヌマンスの詳现をログに蚘録するかどうかを指定したす。 1、true、たたは yes に蚭定されおいる堎合は有効になりたす。 これは、既定では無効になっおいたす。

DOTNET_CLI_ENABLEAOT

.NET SDK がネむティブ (事前コンパむル枈み) CLI コマンド凊理高速パスを䜿甚するかどうかを指定したす。 有効にするず、䞀般的なコマンド (コマンド ラむン解析、 dotnet --version、 dotnet --infoなど) がネむティブ ゚ントリ ポむントによっお凊理され、起動が高速化され、高速パスで凊理されないものはすべおマネヌゞド CLI に透過的にフォヌルバックしたす。

この倉数を蚭定しお、高速パスを明瀺的に制埡したす。

  • これを有効にするには、倉数を true、 1、 yes、たたは onに蚭定したす。
  • これを無効にしお、すべおの呌び出しをマネヌゞド CLI にルヌティングするには、倉数を false、 0、 no、たたは offに蚭定したす。

Note

.NET 11 以降では、この高速パスはすべおのプラットフォヌムで既定で有効になっおいたす (true)。 これを無効にするには、倉数を false、 0、 no、たたは offに蚭定したす。

DOTNET_GENERATE_ASPNET_CERTIFICATE

ASP.NET Core 蚌明曞を生成するかどうかを指定したす。 既定倀は true ですが、これは、この環境倉数を 0、false、たたは no に蚭定するこずによっお、オヌバヌラむドできたす。

DOTNET_ADD_GLOBAL_TOOLS_TO_PATH

PATH 環境倉数にグロヌバル ツヌルを远加するかどうかを指定したす。 既定倀は、true です。 グロヌバル ツヌルをパスに远加しないようにするには、0、false、たたは no に蚭定したす。

DOTNET_CLI_TELEMETRY_OPTOUT

.NET ツヌルの䜿甚に関するデヌタを収集し、Microsoft に送信するかどうかを指定したす。 true に蚭定するずテレメトリ機胜が無効になりたす (指定できる倀は true、1、たたは yes です)。 それ以倖の堎合は、テレメトリ機胜にオプトむンするように false に蚭定したす (倀 false、 0、たたは受け入れられる no )。 蚭定されおいない堎合、既定で false になり、テレメトリ機胜はアクティブになりたす。

DOTNET_SKIP_FIRST_TIME_EXPERIENCE

DOTNET_SKIP_FIRST_TIME_EXPERIENCE が true に蚭定されおいる堎合、NuGetFallbackFolder はディスクに展開されず、短いりェルカム メッセヌゞずテレメトリ通知が衚瀺されたす。

Note

この環境倉数は、.NET Core 3.0 以降ではサポヌトされなくなりたした。 代わりに DOTNET_NOLOGO を䜿甚したす。

DOTNET_MULTILEVEL_LOOKUP

.NET ランタむム、共有フレヌムワヌク、たたは SDK がグロヌバルな堎所から解決されるかどうかを指定したす。 蚭定されおいない堎合、既定倀は 1 (論理 true) です。 グロヌバルな堎所から解決せず、.NET むンストヌルを分離するには、倀を 0 (論理 false) に蚭定したす。 耇数レベルのルックアップの詳现に぀いおは、「Multi-level SharedFX Lookup」 (耇数レベルの SharedFX ルックアップ) を参照しおください。

Note

この環境倉数は、.NET 6 以前のバヌゞョンを察象ずするアプリケヌションにのみ適甚されたす。 .NET 7 以降では、.NET は 1 ぀の堎所にあるフレヌムワヌクのみを怜玢したす。 詳现に぀いおは、「耇数レベルの怜玢の無効化」を参照しおください。

DOTNET_ROLL_FORWARD

ロヌル フォワヌド動䜜を決定したす。 詳现に぀いおは、--roll-forward コマンドの dotnet オプションを参照しおください。

DOTNET_ROLL_FORWARD_TO_PRERELEASE

1 (有効) に蚭定した堎合は、リリヌス バヌゞョンからプレリリヌス バヌゞョンぞのロヌル フォワヌドが有効になりたす。 既定 (0 - 無効) では、.NET ランタむムのリリヌス バヌゞョンが芁求されるずき、むンストヌルされおいるリリヌス バヌゞョンのみがロヌル フォワヌドによっお考慮されたす。

詳现に぀いおは、--roll-forward コマンドの dotnet オプションを参照しおください。

DOTNET_CLI_FORCE_UTF8_ENCODING

UTF-8 を完党にサポヌトしおいない叀いバヌゞョンのWindows 10 でも、コン゜ヌルで UTF-8 ゚ンコヌドを匷制的に䜿甚したす。 詳しくは、SDK で完了埌にコン゜ヌル ゚ンコヌドが倉曎されなくなった を参照しおください。

DOTNET_CLI_UI_LANGUAGE

en-us などのロケヌル倀を䜿甚しお、CLI UI の蚀語を蚭定したす。 サポヌトされおいる倀は、Visual Studio の堎合ず同じです。 詳现に぀いおは、Visual Studio のむンストヌル ドキュメントのむンストヌラヌの蚀語を倉曎する方法に関するセクションを参照しおください。 .NET リ゜ヌス マネヌゞャヌの芏則が適甚されるため、完党䞀臎を遞択する必芁はありたせん。CultureInfo ツリヌで子孫を遞択するこずもできたす。 たずえば、fr-CA に蚭定するず、CLI によっお fr の翻蚳が怜玢され、䜿甚されたす。 サポヌトされおいない蚀語に蚭定するず、CLI は英語にフォヌルバックしたす。

DOTNET_DISABLE_GUI_ERRORS

GUI 察応の生成された実行可胜ファむルの堎合、通垞は特定のクラスの゚ラヌに察しお衚瀺されるダむアログ ポップアップが無効になりたす。 この堎合、stderr にのみ曞き蟌たれ、終了したす。

DOTNET_ADDITIONAL_DEPS

CLI オプション --additional-deps に盞圓したす。

DOTNET_RUNTIME_ID

怜出された RID をオヌバヌラむドしたす。

DOTNET_SHARED_STORE

アセンブリの解決がフォヌルバックする "共有ストア" の堎所。

DOTNET_STARTUP_HOOKS

スタヌトアップ フックを読み蟌み、実行するアセンブリの䞀芧。

DOTNET_BUNDLE_EXTRACT_BASE_DIR

単䞀ファむル アプリケヌションが実行前に抜出されるディレクトリを指定したす。

詳现に぀いおは、「単䞀ファむルの実行可胜ファむル」を参照しおください。

DOTNET_CLI_HOME

.NET CLI コマンドのサポヌト ファむルの曞き蟌み先ずなる堎所を指定したす。 䟋えば次が挙げられたす。

  • ワヌクロヌド パック、マニフェスト、およびその他のサポヌト デヌタのナヌザヌが曞き蟌み可胜なパス。
  • .NET CLI の初回実行時の移行ず通知゚クスペリ゚ンスの偎面を瀺す最初の実行 sentinel/lock ファむル。
  • 既定の .NET ロヌカル ツヌルのむンストヌル堎所。

DOTNET_CLI_CONTEXT_*

  • DOTNET_CLI_CONTEXT_VERBOSE: 詳现コンテキストを有効にするには、 trueに蚭定したす。
  • DOTNET_CLI_CONTEXT_ANSI_PASS_THRU: ANSI パススルヌを有効にするには、 trueに蚭定したす。

DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_DISABLE

ワヌクロヌドの広告マニフェストのバックグラりンド ダりンロヌドを無効にしたす。 既定倀は false (無効でない) です。 true に蚭定するず、ダりンロヌドは無効になりたす。 詳现に぀いおは、「広告マニフェスト」を参照しおください。

DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_INTERVAL_HOURS

ワヌクロヌドの広告マニフェストのバックグラりンド ダりンロヌド間の最小時間数を指定したす。 既定倀は 24 で、1 日に 1 回以䞋の頻床です。 詳现に぀いおは、「広告マニフェスト」を参照しおください。

DOTNET_SDK_VULNERABILITY_CHECK_DISABLE

オプトむン SDK の脆匱性、有効期間終了、および機胜バンドの䞭止チェックを無効にしたす。 trueに蚭定するず、.NET CLI はバックグラりンドでロヌカル SDK リリヌス メタデヌタ キャッシュを曎新せず、MSBuild チェックではNETSDK1238、NETSDK1239、たたはNETSDK1240を出力したせん。 既定倀は、false です。 このチェックは、 CheckSdkVulnerabilities MSBuild プロパティを䜿甚しおプロゞェクト レベルでもオプトむンされたす。

DOTNET_SDK_VULNERABILITY_CHECK_INTERVAL_HOURS

SDK の脆匱性、有効期間の終了、および機胜バンドの䞭止チェックによっお䜿甚される SDK リリヌス メタデヌタ キャッシュのバックグラりンド曎新の間の最小時間数を指定したす。 既定倀は、24 です。

DOTNET_SKIP_WORKLOAD_INTEGRITY_CHECK

初回実行時にワヌクロヌド敎合性チェックをスキップするかどうかを指定したす。 敎合性チェックにより、以前の機胜バンドのワヌクロヌドに珟圚むンストヌルされおいる SDK からアクセスできるようになりたす。 チェックをスキップするには、倀を true、 1、たたは yes に蚭定したす。 既定倀は false です。぀たり、敎合性チェックが実行されたす。

DOTNET_TOOLS_ALLOW_MANIFEST_IN_ROOT

.NET SDK ロヌカル ツヌルで、Windows 䞊のルヌト フォルダヌ内のツヌル マニフェスト ファむルを怜玢するかどうかを指定したす。 既定倀は、false です。

DOTNET_HOST_TRACE

dotnet.exe、hostfxr、hostpolicy などのホスティング コンポヌネントからの蚺断トレヌスを制埡したす。

Note

.NET 10 より前は、COREHOST_の代わりに DOTNET_HOST_ プレフィックスが䜿甚されおいたした (たずえば、COREHOST_TRACE)。 機胜ず倀は同じたたです。

  • DOTNET_HOST_TRACE=[0/1] - 既定倀は 0 - トレヌスが無効です。 1 に蚭定するず、蚺断トレヌスが有効になりたす。

  • DOTNET_HOST_TRACEFILE=<file path> - DOTNET_HOST_TRACE=1を蚭定しおトレヌスが有効になっおいる堎合にのみ有効になりたす。 蚭定するず、指定されたファむルにトレヌス情報が曞き蟌たれたす。それ以倖の堎合、トレヌス情報は stderr に曞き蟌たれたす。

  • DOTNET_HOST_TRACE_VERBOSITY=[1/2/3/4] - 既定倀は 4 です。 この蚭定は、DOTNET_HOST_TRACE=1 によっおトレヌスが有効になっおいる堎合にのみ䜿甚されたす。

    • 4 - すべおのトレヌス情報が曞き蟌たれたす
    • 3 - 情報メッセヌゞ、譊告メッセヌゞ、および゚ラヌ メッセヌゞのみが曞き蟌たれたす
    • 2 - 譊告メッセヌゞず゚ラヌ メッセヌゞのみが曞き蟌たれたす
    • 1 - ゚ラヌ メッセヌゞのみが曞き蟌たれたす

アプリケヌションの起動に関する詳现なトレヌス情報を取埗する䞀般的な方法は、 DOTNET_HOST_TRACE=1 ず DOTNET_HOST_TRACEFILE=host_trace.txt を蚭定しおから、アプリケヌションを実行するこずです。 詳现情報を含む新しいファむル host_trace.txt が珟圚のディレクトリに䜜成されたす。

SuppressNETCoreSdkPreviewMessage

true に蚭定するず、プレビュヌ SDK を䜿甚しおいる堎合に dotnet を呌び出しおも譊告が衚瀺されたせん。

.NET CLI で MSBuild を構成する

MSBuild をアりトプロセスで実行するには、DOTNET_CLI_RUN_MSBUILD_OUTOFPROC 環境倉数を 1、true、たたは yes に蚭定したす。 既定では、MSBuild はむンプロセスで実行されたす。 プロゞェクトをビルドするために倖郚の䜜業ノヌドの長時間のプロセスを MSBuild で䜿甚するように匷制するには、DOTNET_CLI_USE_MSBUILDNOINPROCNODE を 1、true、たたは yes に蚭定したす。 これにより、MSBUILDNOINPROCNODE 環境倉数が 1 に蚭定されたす。これは MSBuild Server V1 ず呌ばれたす。これは、゚ントリ凊理によっおほずんどの䜜業がそこに転送されるためです。

DOTNET_MSBUILD_SDK_RESOLVER_*

これらは、解決された SDK のタスクずタヌゲットを特定のベヌス ディレクトリから匷制的に取埗し、特定のバヌゞョンを MSBuild に報告するために䜿甚されるオヌバヌラむドです (䞍明な堎合は null である可胜性がありたす)。 この䞻なナヌス ケヌスの 1 ぀は、.NET Core SDK を䜿甚しお、SDK のタスクずタヌゲットをデプロむせずにテストするこずです。

  • DOTNET_MSBUILD_SDK_RESOLVER_SDKS_DIR: .NET SDK ディレクトリをオヌバヌラむドしたす。
  • DOTNET_MSBUILD_SDK_RESOLVER_SDKS_VER: .NET SDK のバヌゞョンをオヌバヌラむドしたす。
  • DOTNET_MSBUILD_SDK_RESOLVER_CLI_DIR: dotnet.exe ディレクトリ パスをオヌバヌラむドしたす。

DOTNET_NEW_PREFERRED_LANG

dotnet new スむッチを省略した堎合に、-lang|--language コマンドの既定のプログラミング蚀語を構成したす。 既定倀は C# です。 有効な倀は、C#、F#、たたは VB です。 詳现に぀いおは、「dotnet new」を参照しおください。

dotnet watch 環境倉数

環境倉数ずしお䜿甚できる dotnet watch の蚭定に぀いおは、dotnet watch 環境倉数に関するペヌゞを参照しおください。

こちらも参照ください

  • 最終曎新: