az ml workspace-hub

注意

此參考是 Azure CLI 的 ml 延伸模組的一部分（2.15.0 版或更高版本）。 擴充功能會在您第一次執行 az ml workspace-hub 命令時自動安裝。 深入了解擴充功能。

此命令群組處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

管理 Azure ML WorkspaceHub。

WorkspaceHub 是用來協助管理和建立 Azure 機器學習 工作區的資源。 它提供一組 Azure ML 工作區的集中式 Azure 設定。

命令

名稱	Description	類型	狀態
az ml workspace-hub create	建立 WorkspaceHub。	副檔名	預覽
az ml workspace-hub delete	刪除 WorkspaceHub。	副檔名	預覽
az ml workspace-hub list	列出訂用帳戶中的所有 WorkspaceHubs。	副檔名	預覽
az ml workspace-hub show	顯示 WorkspaceHub 的詳細數據。	副檔名	預覽
az ml workspace-hub update	更新 WorkspaceHub。	副檔名	預覽

az ml workspace-hub create

預覽

命令群組 『ml workspace-hub』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

建立 WorkspaceHub。

建立 WorkspaceHub 時，Azure ML 將使用的數個 Azure 資源預設也會建立：Azure 儲存體、Azure 金鑰保存庫。 您可以在 WorkspaceHub 的組態 YAML 檔案中指定資源標識符，來改為在建立 WorkspaceHub 時，針對那些實例使用現有的 Azure 資源實例。

az ml workspace-hub create --resource-group
                           [--additional-workspace-storage-accounts]
                           [--container-registry]
                           [--default-workspace-resource-group]
                           [--description]
                           [--display-name]
                           [--file]
                           [--key-vault]
                           [--location]
                           [--managed-network]
                           [--name]
                           [--no-wait]
                           [--primary-user-assigned-identity]
                           [--public-network-access]
                           [--set]
                           [--storage-account]
                           [--tags]
                           [--update-dependent-resources]

範例

從 YAML 規格檔案建立 WorkspaceHub。

az ml workspace-hub create --file workspace-hub.yml --resource-group my-resource-group

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

選擇性參數

--additional-workspace-storage-accounts -a

除了預設帳戶之外，還會使用之現有記憶體帳戶的逗號分隔資源標識符清單。

--container-registry -c

與此 WorkspaceHub 相關聯的容器登錄 ARM 識別碼。

--default-workspace-resource-group -d

加入 workspaceHub 之任何 Project 工作區的目的地資源群組，預設為 workspaceHub 的資源群組。

--description

Azure ML WorkspaceHub 的描述。

--display-name

WorkspaceHub 的顯示名稱。

--file -f

包含 Azure ML 工作區中樞規格之 YAML 檔案的本機路徑。 如需工作區中樞的 YAML 參考檔，請參閱： https://aka.ms/ml-cli-v2-workspace-hub-entity-yaml-reference。

--key-vault -k

與此 WorkspaceHub 相關聯的金鑰保存庫 ARM 識別碼。

--location -l

要用於新 WorkspaceHub 的位置。

--managed-network -m

預覽

WorkspaceHub 的受控網路隔離模式。

--name -n

Azure ML WorkspaceHub 的名稱。

--no-wait

請勿等候 WorkspaceHub 建立完成。

預設值: False

--primary-user-assigned-identity -p

指定多個受控識別時，主要使用者指派受控識別的 ARM 識別碼。 此外，適用於無叢集計算的預設受控識別。

--public-network-access

啟用 WorkspaceHub 時允許公用端點連線。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=。

--storage-account -s

與此 WorkspaceHub 相關聯的記憶體帳戶 ARM 識別碼。

--tags

對象標記的空間分隔索引鍵/值組。

--update-dependent-resources -u

指定 --update_dependent_resources，表示您同意更新工作區相依資源。 更新工作區連結的 Azure Container Registry 或 Application Insights 資源可能會中斷先前作業的譜系、已部署的推斷端點，或您在此工作區中重新執行先前作業的能力。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml workspace-hub delete

預覽

命令群組 『ml workspace-hub』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

刪除 WorkspaceHub。

根據預設，不會刪除與 WorkspaceHub 相關聯的相依資源（Azure 儲存體、Azure Container Registries、Azure 金鑰保存庫 s）。 若要同時刪除這些專案，請包含 --all-resources。 若要永久刪除 WorkspaceHub，請包含 --permanently-delete。

az ml workspace-hub delete --name
                           --resource-group
                           [--all-resources]
                           [--no-wait]
                           [--permanently-delete]
                           [--yes]

必要參數

--name -n

Azure ML WorkspaceHub 的名稱。 您可以使用 來設定預設群組 az configure --defaults workspace=<name>。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

選擇性參數

--all-resources

刪除與 WorkspaceHub 相關聯的所有相依資源（Azure 儲存體 帳戶、Azure Container Registry、Azure 應用程式 Insights、Azure 金鑰保存庫）。

預設值: False

--no-wait

請勿等候長時間執行的作業完成。 預設值是 False。

預設值: False

--permanently-delete -p

WorkspaceHub 預設為虛刪除狀態，以允許復原數據。 設定此旗標以覆寫虛刪除行為，並永久刪除您的工作區中樞。

預設值: False

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml workspace-hub list

預覽

命令群組 『ml workspace-hub』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

列出訂用帳戶中的所有 WorkspaceHubs。

WorkspaceHub 清單可以依資源群組進行篩選。

az ml workspace-hub list [--max-results]
                         [--resource-group]

範例

列出資源群組中的所有 WorkspaceHubs

az ml workspace-hub list --resource-group my-resource-group

使用 --query 自變數列出所有 WorkspaceHubs，以在命令結果上執行 JMESPath 查詢。

az ml workspace-hub list --query "[].{Name:name}"  --output table --resource-group my-resource-group

選擇性參數

--max-results -r

要傳回的結果數目上限。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml workspace-hub show

預覽

命令群組 『ml workspace-hub』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

顯示 WorkspaceHub 的詳細數據。

az ml workspace-hub show --name
                         --resource-group

必要參數

--name -n

Azure ML WorkspaceHub 的名稱。 您可以使用 來設定預設群組 az configure --defaults workspace=<name>。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az ml workspace-hub update

預覽

命令群組 『ml workspace-hub』 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

更新 WorkspaceHub。

可以更新 'description'、'tags' 和 'friendly_name' 屬性。

az ml workspace-hub update --name
                           --resource-group
                           [--add]
                           [--description]
                           [--display-name]
                           [--file]
                           [--force-string]
                           [--managed-network]
                           [--no-wait]
                           [--primary-user-assigned-identity]
                           [--public-network-access]
                           [--remove]
                           [--set]
                           [--update-dependent-resources]

範例

從 YAML 規格檔案更新 WorkspaceHub。

az ml workspace-hub update --resource-group my-resource-group --name my-workspace-hub-name --file workspace-hub.yml

必要參數

--name -n

Azure ML WorkspaceHub 的名稱。 您可以使用 來設定預設群組 az configure --defaults workspace=<name>。

--resource-group -g

資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>。

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value, string or JSON string>。

預設值: []

--description

Azure ML WorkspaceHub 的描述。

--display-name

WorkspaceHub 的顯示名稱。

--file -f

包含 Azure ML 工作區中樞規格之 YAML 檔案的本機路徑。 如需工作區中樞的 YAML 參考檔，請參閱： https://aka.ms/ml-cli-v2-workspace-hub-entity-yaml-reference。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

預設值: False

--managed-network -m

預覽

WorkspaceHub 的受控網路隔離模式。

--no-wait

請勿等候長時間執行的作業完成。 預設值是 False。

預設值: False

--primary-user-assigned-identity -p

與此 WorkspaceHub 相關聯的主要使用者指派身分識別的 ARM 識別碼。

--public-network-access

啟用 WorkspaceHub 時允許公用端點連線。

--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

預設值: []

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=<value>。

預設值: []

--update-dependent-resources -u

指定 --update_dependent_resources，表示您同意更新工作區相依資源。 更新工作區連結的 Azure Container Registry 或 Application Insights 資源可能會中斷先前作業的譜系、已部署的推斷端點，或您在此工作區中重新執行先前作業的能力。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。