.NET Core CLI ツールのドキュメント dotnet-install スクリプト リファレンス

名前

dotnet-install.ps1 | dotnet-install.sh - コマンド ライン インターフェイス (CLI) ツールをインストールするためのスクリプトと共有ランタイム

概要

Windows:

dotnet-install.ps1 [-チャネル] [-バージョン] [-InstallDir] [-Debug] [-NoPath] [-SharedRuntime]

OS X/Linux:

dotnet-install.sh [--channel] [--version] [--install-dir ] [- -debug] [--no-path] [--shared-runtime]

説明

dotnet-install インストール スクリプトは、CLI ツールチェーンと共有ランタイムの非管理者インストールを実行するために使用されます。スクリプトは CLI GitHub リポジトリからダウンロードできます。

これは主に自動化シナリオと管理者以外のインストールを支援するために使用されます。スクリプトは 2 つあり、1 つは Windows で動作する PowerShell で、もう 1 つは Linux/OS X で動作する bash スクリプトです。どちらも同じ動作をします。 Bash スクリプトは PowerShell スイッチも「理解」するため、それらを全般的に使用できます。

インストール スクリプトは、CLI から ZIP/tarball (圧縮パッケージ) ファイルをダウンロードすることによって生成され、デフォルトの場所または --install-dir で指定された場所にインストールされます。デフォルトでは、インストール スクリプトは SDK をダウンロードしてインストールします。共有ランタイムを取得するだけの場合は、--shared-runtime パラメーターを指定できます。

デフォルトでは、インストール スクリプトは現在のセッションの $PATH にインストール場所を追加します。 --no-path パラメーターが使用されている場合、これはオーバーライドできます。

スクリプトを実行する前に、必要な依存関係をすべてインストールしてください。

--version パラメーターを使用して、特定のバージョンをインストールできます。指定されたバージョンには 3 部構成のバージョンが必要です (例: 1.0.0-13232)。省略した場合、呼び出されたスクリプトの親フォルダーにある sdkVersion ノードを含む最初の global.json ファイルがデフォルトになります。存在しない場合は、最新のものを使用します。

--debug パラメーターを使用して、このスクリプトを使用して SDK のデバッグ バイナリや共有ランタイム デバッグ シンボルを取得することもできます。初めてインストールするときにこれを行わず、後で実際にデバッグ シンボルが必要になった場合は、このパラメータとインストールしたバージョンを使用してスクリプトを再実行できます。

オプション

さまざまなスクリプト実装のオプション。

PowerShell (Windows)

-チャネル [CHANNEL]

インストールするチャネル (例: "future"、"preview"、"production")。デフォルトのバージョンは「Production」です。

-Version [VERSION]

インストールされている CLI のバージョン。 3 部構成のバージョンを指定する必要があります (例: 1.0.0-13232)。省略した場合、呼び出されたスクリプトの親フォルダーにある sdkVersion ノードを含む最初の global.json ファイルがデフォルトになります。存在しない場合は、最新のものを使用します。

-InstallDir [DIR]

インストールパス。ディレクトリが存在しない場合は作成します。デフォルト値は %LocalAppData%.dotnet です。

-デバッグ

true は、デバッグ シンボルを含むより大きなパッケージを使用する必要があることを示します。それ以外の場合は false です。デフォルト値は false です。

-NoPath

true は、プレフィックス/インストール ディレクトリが現在のセッションのパスにエクスポートされないことを示します。それ以外の場合は false です。デフォルト値は false です。つまり、PATH は変更されます。これにより、インストール後すぐに CLI ツールを使用できるようになります。

-SharedRuntime

tru​​e は共有ランタイムのみをインストールします。 false は SDK 全体をインストールします。デフォルト値は false です。

Bash (OS)デフォルトのバージョンは「Production」です。

--version [VERSION]

インストールされている CLI のバージョン。 3 部構成のバージョンを指定する必要があります (例: 1.0.0-13232)。省略した場合、デフォルトで sdkVersion ノードを含む最初の global.json ファイルが使用されます。存在しない場合は、最新のものを使用します。

--install-dir [DIR]

インストールパス。ディレクトリが存在しない場合は作成します。デフォルト値は %HOME%/.dotnet です。

--debug

true は、デバッグ シンボルを含むより大きなパッケージを使用する必要があることを示します。それ以外の場合は、 false です。デフォルト値は false です。

--no-path

true は、プレフィックス/インストール ディレクトリが現在のセッションのパスにエクスポートされないことを示します。それ以外の場合は false です。デフォルト値は false です。つまり、PATH は変更されます。これにより、インストール後すぐに CLI ツールを使用できるようになります。

--shared-runtime

tru​​e は共有ランタイムのみをインストールします。 false は SDK 全体をインストールします。デフォルト値は false です。

例

Windows:

./dotnet-install.ps1 -Channel Future

./dotnet-install.sh --channel Future

Windows:

./dotnet-install.ps1 -チャンネルプレビュー -InstallDir C:cli

./dotnet-install.sh --channelプレビュー --install-dir ~ /cli