.NET Core CLI工具文檔dotnet-install 指令碼參考

名稱

dotnet-install.ps1 | dotnet-install.sh - 用於安裝命令列介面（CLI）工具的指令碼和共用運行時

概要

Windows:

dotnet-install.ps1 [-Channel] [-Version] [-InstallDir] [-Debug] [-NoPath] [-SharedRuntime]

OS X/Linux:

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

描述

dotnet-install 安裝指令碼用來執行非管理員安裝 CLI 工具鏈和共用運行時。你可以從我們的 CLI GitHub repo 下載指令碼。

其主要用於協助自動化情境和非管理員安裝。有兩個指令碼，一個是在 Windows 上工作的 PowerShell 和另一個在 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 [CHANNEL]

安裝的渠道（例如：“future”、“preview”、“production”）。預設版本是“Production”。

-Version [VERSION]

安裝的 CLI 版本。你需要指定由 3 部分組成的版本（例如：1.0.0-13232）。如果忽略，它將預設到被呼叫指令碼的上級檔案夾中找到的第一個包含 sdkVersion節點的 global.json 檔案。如果不存在，它會使用最新的。

-InstallDir [DIR]

安裝的路徑。如果目錄不存在則建立它。預設值是 %LocalAppData%\.dotnet。

-Debug

true 表明應該使用包含偵錯符號的更大包；否則，false。預設值是 false。

-NoPath

true 表明首碼/安裝目錄不匯出到當前會話的路徑；否則，false。預設值是 false，那就是，PATH 被修改。這使得 CLI 工具安裝後立即可用。

-SharedRuntime

true 僅僅安裝共用運行時。false 安裝整個 SDK。預設值是 false。

Bash (OS X/Linux)

--channel [CHANNEL]

安裝的渠道（例如：“future”、“preview”、“production”）。預設版本是“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

true 僅僅安裝共用運行時。false 安裝整個 SDK。預設值是 false。

例子

Windows:

./dotnet-install.ps1 -Channel Future

OS X/Linux:

./dotnet-install.sh --channel Future

安裝最新的開發版本到預設位置。

Windows:

./dotnet-install.ps1 -Channel preview -InstallDir C:\cli

OS X/Linux:

./dotnet-install.sh --channel preview --install-dir ~/cli

安裝最新的預覽版本到指定的位置。

