共用方式為

如何安裝 ML.NET Command-Line接口 （CLI） 工具

  • 發行項

瞭解如何在 Windows、Mac 或 Linux 上安裝 ML.NET CLI （命令行介面）。

ML.NET CLI 會使用自動化機器學習 （AutoML） 和定型數據集，產生高品質的 ML.NET 模型和原始程式碼。

注意

本文指的是目前處於預覽狀態的 ML.NET CLI 和 ML.NET AutoML，且內容可能會變更。

先決條件

您可以按 F5 鍵或使用 dotnet run （.NET CLI） 來執行產生的 C# 程式代碼專案。

注意：如果在安裝 .NET SDK 之後，dotnet tool 命令無法運作，請註銷 Windows 並再次登入。

安裝

ML.NET CLI 的安裝方式與其他 dotnet Global Tool 一樣。 您可以使用 dotnet tool install --global .NET CLI 命令。

ML.NET CLI 適用於 Windows、macOS 和 Linux。 根據您的處理器架構，選擇 x64 或 ARM 版本。

注意

ARM 型 ML.NET CLI 版本不支援影像分類案例。

x64

dotnet tool install --global mlnet-win-x64

ARM架構

dotnet tool install --global mlnet-win-arm64

如果無法安裝此工具（也就是說，如果預設的 NuGet 程式庫不可用），則會顯示錯誤訊息。 檢查您預期的資料來源是否被檢查。

如果安裝成功，會顯示一則訊息，其中顯示用來呼叫工具和已安裝版本的命令，類似下列範例：

You can invoke the tool using the following command: mlnet
Tool 'mlnet-<OS>-<ARCH>' (version 'X.X.X') was successfully installed.

在此情況下，OS 和 ARCH 應該符合安裝 ML.NET CLI 時所選取作業系統和處理器架構的值。

您可以輸入下列命令來確認安裝成功：

mlnet

您應該會看到 mlnet 工具可用命令的說明，例如 『classification』 命令。

重要

如果您正在執行 Linux 或 macOS，並使用 Bash 以外的控制台（例如 zsh，這是 macOS 的新預設值），則必須提供 mlnet 可執行文件許可權，並將 mlnet 納入系統路徑。 一般而言，您可以使用下列命令來執行此動作：

chmod +x <PATH-TO-MLNET-CLI-EXECUTABLE>

當您安裝 mlnet 或任何全域工具時，如何執行這項操作的詳細指示應該會出現在終端機中。

或者，您也可以嘗試使用下列命令來執行 mlnet 工具：

~/.dotnet/tools/mlnet

安裝特定發行版本

如果您嘗試安裝發行前版本或工具的特定版本，您可以使用下列格式來指定 OS、處理器架構和 架構：

dotnet tool install -g mlnet-<OS>-<ARCH> --framework <FRAMEWORK>

您也可以輸入下列命令來檢查套件是否已正確安裝：

dotnet tool list -g

卸載 CLI 套件

若要卸載 ML.NET CLI，請使用您可以從執行 dotnet tool list --global 命令取得的套件識別碼。 然後，使用 dotnet tool uninstall --global 命令。

x64

dotnet tool uninstall --global mlnet-win-x64

ARM

dotnet tool uninstall --global mlnet-win-arm64

更新 CLI 套件

若要更新 ML.NET CLI，請使用您可以從執行 dotnet tool list --global 命令取得的套件識別碼。 然後，使用 dotnet tool update --global 命令。

x64

dotnet tool update --global mlnet-win-x64

手臂

dotnet tool update --global mlnet-win-arm64

安裝目錄

ML.NET CLI 可以安裝在預設目錄或特定位置。 預設目錄為：

操作系統 路徑
Linux/macOS $HOME/.dotnet/tools
窗戶 %USERPROFILE%\.dotnet\tools

SDK 第一次執行時，這些位置會新增至用戶的路徑，因此可以直接呼叫該處的 Global Tools。

注意：全域工具是使用者特定的，而不是計算機全域。 指定使用者意味著您無法安裝可供整個系統所有使用者使用的全域工具。 此工具僅適用於安裝工具的每個使用者配置檔。

全域工具也可以安裝在特定目錄中。 安裝在特定目錄中時，用戶必須確定命令可供使用，方法是在路徑中包含該目錄、使用指定的目錄呼叫 命令，或從指定的目錄中呼叫工具。 在此情況下，.NET CLI 不會自動將此位置新增至PATH環境變數。

另請參閱