az ml workspace

參考

注意

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

工作區子群組命令。

命令

名稱	Description	類型	狀態
az ml workspace create	建立工作區。	副檔名	GA
az ml workspace delete	刪除工作區。	副檔名	GA
az ml workspace diagnose	診斷工作區設定問題。	副檔名	GA
az ml workspace list	列出工作區。	副檔名	GA
az ml workspace list-keys	列出相依資源的工作區密鑰，例如記憶體、acr 和應用程式深入解析。	副檔名	GA
az ml workspace private-endpoint	工作區私人端點子群組命令。	副檔名	GA
az ml workspace private-endpoint add	將私人端點新增至工作區。	副檔名	GA
az ml workspace private-endpoint delete	刪除工作區中指定的私人端點連線。	副檔名	GA
az ml workspace private-endpoint list	列出工作區中的所有私人端點。	副檔名	GA
az ml workspace share	與另一個具有指定角色的用戶共用工作區。	副檔名	GA
az ml workspace show	顯示工作區。	副檔名	GA
az ml workspace sync-keys	同步處理相依資源的工作區密鑰，例如記憶體、acr 和應用程式深入解析。	副檔名	GA
az ml workspace update	更新工作區。	副檔名	GA
az ml workspace update-dependencies	更新工作區相依資源。	副檔名	GA

az ml workspace create

建立工作區。

az ml workspace create --workspace-name
                       [--adb-workspace]
                       [--application-insights]
                       [--cmk-keyvault]
                       [--container-registry]
                       [--exist-ok]
                       [--friendly-name]
                       [--hbi-workspace]
                       [--keyvault]
                       [--location]
                       [--pe-auto-approval]
                       [--pe-name]
                       [--pe-resource-group]
                       [--pe-subnet-name]
                       [--pe-subscription-id]
                       [--pe-vnet-name]
                       [--primary-user-assigned-identity]
                       [--resource-cmk-uri]
                       [--resource-group]
                       [--sku]
                       [--storage-account]
                       [--system_datastores_auth_mode]
                       [--tags]
                       [--user-assigned-identity-for-cmk-encryption]
                       [--v1-legacy-mode]
                       [--yes]

必要參數

--workspace-name -w

工作區名稱。

選擇性參數

--adb-workspace

要與這個工作區連結的Adb工作區。

--application-insights

要與此工作區相關聯的 Application Insights。

--cmk-keyvault

金鑰保存庫，其中包含 Azure 資源識別碼格式的客戶受控密鑰。

--container-registry

要與此工作區相關聯的 Container Registry。

--exist-ok

如果工作區存在，請勿失敗。

預設值: False

--friendly-name -f

此工作區的易記名稱。

--hbi-workspace

指定客戶數據是否為高業務影響（HBI），亦即包含敏感性商務資訊。

預設值: False

--keyvault

金鑰保存庫與此工作區相關聯。

--location -l

資源的位置。

--pe-auto-approval

是否應該自動核准透過私人連結連線至工作區資源的私人端點。

預設值: False

--pe-name

工作區私人端點的名稱。使用此參數可透過私人端點限制工作區存取專用網。

--pe-resource-group

要用來建立工作區私人端點的現有資源群組名稱。 vnet 應該位於相同的資源群組中。如果未指定，則會使用工作區的資源群組。

--pe-subnet-name

要用來建立工作區私人端點的現有子網名稱。

預設值: default

--pe-subscription-id

要在其中建立工作區私人端點的現有訂用帳戶標識碼。 vnet 應該位於相同的訂用帳戶中。如果未指定，則會使用工作區的訂用帳戶標識碼。

--pe-vnet-name

要用來建立工作區私人端點的現有 vnet 名稱。

--primary-user-assigned-identity

用來表示工作區身分識別的使用者指派身分識別 resourceId。

--resource-cmk-uri

客戶管理金鑰的金鑰 URI，用來加密待用數據。

--resource-group -g

資源組名。

--sku

工作區的 SKU/版本 -可以是「基本」工作區或功能豐富的「企業」工作區。

預設值: basic

--storage-account

儲存體要與此工作區相關聯的帳戶。

--system_datastores_auth_mode

判斷是否要使用工作區 'workspaceblobstore' 和 'workspacefilestore' 的系統數據存放區認證。默認值為 'accessKey'，在此情況下，工作區會建立具有認證的系統數據存放區。如果設定為「身分識別」，工作區將會建立沒有認證的系統數據存放區。

預設值: accessKey

--tags -t

與此工作區相關聯的標記與 'key=value' 語法。

--user-assigned-identity-for-cmk-encryption

需要用來存取加密金鑰的使用者指派身分識別 resourceId。

--v1-legacy-mode -v

如果您設定此參數 true，請避免在公用 Azure Resource Manager 上使用 v2 API 服務。若要深入瞭解，請參閱 aka.ms/amlv2network。

--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 delete

刪除工作區。

az ml workspace delete [--all-resources]
                       [--no-wait]
                       [--output-metadata-file]
                       [--path]
                       [--resource-group]
                       [--subscription-id]
                       [--workspace-name]

選擇性參數

--all-resources

刪除此工作區相依的資源，例如記憶體、acr、kv 和應用程式深入解析。

預設值: False

--no-wait

請勿等候工作區刪除完成。

預設值: False

--output-metadata-file -t

提供結構化物件輸出的選擇性輸出檔位置。

--path

執行組態檔的根目錄路徑。

預設值: .

--resource-group -g

資源組名。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

工作區名稱。

全域參數

--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 diagnose

診斷工作區設定問題。

az ml workspace diagnose [--output-metadata-file]
                         [--path]
                         [--resource-group]
                         [--subscription-id]
                         [--workspace-name]

選擇性參數

--output-metadata-file -t

提供結構化物件輸出的選擇性輸出檔位置。

--path

執行組態檔的根目錄路徑。

預設值: .

--resource-group -g

資源組名。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

工作區名稱。

全域參數

--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 list

列出工作區。

az ml workspace list [--resource-group]

選擇性參數

--resource-group -g

資源組名。

全域參數

--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 list-keys

列出相依資源的工作區密鑰，例如記憶體、acr 和應用程式深入解析。

az ml workspace list-keys [--output-metadata-file]
                          [--path]
                          [--resource-group]
                          [--subscription-id]
                          [--workspace-name]

選擇性參數

--output-metadata-file -t

提供結構化物件輸出的選擇性輸出檔位置。

--path

執行組態檔的根目錄路徑。

預設值: .

--resource-group -g

資源組名。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

工作區名稱。

全域參數

--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 share --role
                      --user
                      [--output-metadata-file]
                      [--path]
                      [--resource-group]
                      [--subscription-id]
                      [--workspace-name]

--role

要指派給此使用者的角色。

--user

要與其共用此工作區的使用者。

--output-metadata-file -t

提供結構化物件輸出的選擇性輸出檔位置。

--path

執行組態檔的根目錄路徑。

預設值: .

--resource-group -g

資源組名。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

工作區名稱。

全域參數

--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 show

顯示工作區。

az ml workspace show [--output-metadata-file]
                     [--path]
                     [--resource-group]
                     [--subscription-id]
                     [--workspace-name]

選擇性參數

--output-metadata-file -t

提供結構化物件輸出的選擇性輸出檔位置。

--path

執行組態檔的根目錄路徑。

預設值: .

--resource-group -g

資源組名。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

工作區名稱。

全域參數

--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 sync-keys

同步處理相依資源的工作區密鑰，例如記憶體、acr 和應用程式深入解析。

az ml workspace sync-keys [--output-metadata-file]
                          [--path]
                          [--resource-group]
                          [--subscription-id]
                          [--workspace-name]

選擇性參數

--output-metadata-file -t

提供結構化物件輸出的選擇性輸出檔位置。

--path

執行組態檔的根目錄路徑。

預設值: .

--resource-group -g

資源組名。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

工作區名稱。

全域參數

--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 update

更新工作區。

az ml workspace update [--allow-public-access]
                       [--description]
                       [--friendly-name]
                       [--image-build-compute]
                       [--output-metadata-file]
                       [--path]
                       [--primary-user-assigned-identity]
                       [--resource-group]
                       [--subscription-id]
                       [--tags]
                       [--v1-legacy-mode]
                       [--workspace-name]

選擇性參數

--allow-public-access

允許公用存取私人連結工作區。

--description -d

此工作區的描述。

--friendly-name -f

易記名稱。

--image-build-compute

映射組建的計算目標。

--output-metadata-file -t

提供結構化物件輸出的選擇性輸出檔位置。

--path

執行組態檔的根目錄路徑。

預設值: .

--primary-user-assigned-identity

用來表示工作區身分識別的使用者指派身分識別 resourceId。

--resource-group -g

資源組名。

--subscription-id

指定訂用帳戶標識碼。

--tags

與此工作區相關聯的標記與 'key=value' 語法。

--v1-legacy-mode -v

如果您設定此參數 true，請避免在公用 Azure Resource Manager 上使用 v2 API 服務。若要深入瞭解，請參閱 aka.ms/amlv2network。

--workspace-name -w

工作區名稱。

全域參數

--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 update-dependencies

更新工作區相依資源。

az ml workspace update-dependencies [--acr]
                                    [--force]
                                    [--output-metadata-file]
                                    [--path]
                                    [--resource-group]
                                    [--subscription-id]
                                    [--workspace-name]

選擇性參數

--acr

您想要更新此工作區之容器登錄的arm識別碼。

--force

強制更新相依資源，而不需使用者的確認。

預設值: False

--output-metadata-file -t

提供結構化物件輸出的選擇性輸出檔位置。

--path

執行組態檔的根目錄路徑。

預設值: .

--resource-group -g

資源組名。

--subscription-id

指定訂用帳戶標識碼。

--workspace-name -w

工作區名稱。

全域參數

--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

命令

az ml workspace create

必要參數

選擇性參數

az ml workspace delete

選擇性參數

az ml workspace diagnose

選擇性參數

az ml workspace list

選擇性參數

az ml workspace list-keys

選擇性參數

az ml workspace show

選擇性參數

az ml workspace sync-keys

選擇性參數

az ml workspace update

選擇性參數

az ml workspace update-dependencies

選擇性參數

其他資源