.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

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

-SharedRuntime

tru​​e 僅安裝共享執行時間。 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

tru​​e 表示應該使用包含除錯符號的更大套件；否則，false。預設值是 false。

--no-path

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

--shared-runtime

tru​​e 僅安裝共用運作時。 false 安裝整個 SDK。預設值是 false。

範例

Windows:

./dotnet-install.ps1 -Channel Future

OS X/Linux:

./dotnet-install.sh --channelnelone Futureponeduo
。位置。

Windows:

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

OS X/Linux:

./com-install. /cli

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