az devcenter dev customization-task

參考

注意

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

管理自定義工作。

命令

名稱	Description	類型	狀態
az devcenter dev customization-task list	列出自定義工作。	副檔名	GA
az devcenter dev customization-task show	取得自定義工作。	副檔名	GA
az devcenter dev customization-task show-logs	顯示自訂工作的記錄。	副檔名	GA
az devcenter dev customization-task validate	驗證自定義工作。	副檔名	GA

az devcenter dev customization-task list

列出自定義工作。

az devcenter dev customization-task list --project
                                         [--dev-center]
                                         [--endpoint]

範例

使用開發人員中心列出

az devcenter dev customization-task list --dev-center-name "ContosoDevCenter" --project-name "DevProject"

使用端點列出

az devcenter dev customization-task list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject"

必要參數

--project --project-name

專案的名稱。使用 az configure -d project=<project_name> 來設定預設值。

選擇性參數

--dev-center --dev-center-name -d

開發人員中心的名稱。使用 az configure -d dev-center=<dev_center_name> 來設定預設值。

--endpoint

開發人員資源的 API 端點。使用 az configure -d endpoint=<endpoint_uri> 來設定預設值。

全域參數

--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 devcenter dev customization-task show

取得自定義工作。

az devcenter dev customization-task show --catalog-name
                                         --project
                                         --task-name
                                         [--dev-center]
                                         [--endpoint]

範例

使用開發人員中心

az devcenter dev customization-task show --dev-center-name "ContosoDevCenter" --project-name "DevProject" --task-name "choco" --catalog-name "myCatalog"

使用端點

az devcenter dev customization-task show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --task-name "choco" --catalog-name "myCatalog"

必要參數

--catalog-name

目錄的名稱。

--project --project-name

專案的名稱。使用 az configure -d project=<project_name> 來設定預設值。

--task-name

工作的名稱。

選擇性參數

--dev-center --dev-center-name -d

開發人員中心的名稱。使用 az configure -d dev-center=<dev_center_name> 來設定預設值。

--endpoint

開發人員資源的 API 端點。使用 az configure -d endpoint=<endpoint_uri> 來設定預設值。

全域參數

--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 devcenter dev customization-task show-logs

顯示自訂工作的記錄。

az devcenter dev customization-task show-logs --customization-group-name
                                              --customization-task-id
                                              --dev-box
                                              --project
                                              [--dev-center]
                                              [--endpoint]
                                              [--user-id]

範例

使用開發人員中心

az devcenter dev customization-task show-logs --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --customization-group-name "Provisioning" --customization-task-id "91835dc0-ef5a-4f58-9e3a-099aea8481f4" --user-id "00000000-0000-0000-0000-000000000000"

使用端點

az devcenter dev customization-task show-logs --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --customization-group-name "Provisioning" --customization-task-id "91835dc0-ef5a-4f58-9e3a-099aea8481f4" --user-id "00000000-0000-0000-0000-000000000000"

必要參數

--customization-group-name --name -n

自訂群組的名稱。

--customization-task-id --task-id-t

開發方塊的名稱。

--dev-box --dev-box-name

開發方塊的名稱。

--project --project-name

專案的名稱。使用 az configure -d project=<project_name> 來設定預設值。

選擇性參數

--dev-center --dev-center-name -d

開發人員中心的名稱。使用 az configure -d dev-center=<dev_center_name> 來設定預設值。

--endpoint

開發人員資源的 API 端點。使用 az configure -d endpoint=<endpoint_uri> 來設定預設值。

--user-id

使用者的 AAD 物件識別碼。如果值為『me』，則會從驗證內容擷取身分識別。

預設值: me

全域參數

--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 devcenter dev customization-task validate

驗證自定義工作。

az devcenter dev customization-task validate --project
                                             --tasks
                                             [--dev-center]
                                             [--endpoint]

範例

使用開發人員中心進行驗證

az devcenter dev customization-task validate --dev-center-name "ContosoDevCenter" --project-name "DevProject" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]"

使用端點進行驗證

az devcenter dev customization-task validate --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]"

必要參數

--project --project-name

專案的名稱。使用 az configure -d project=<project_name> 來設定預設值。

--tasks

工作的 Parameters 物件。預期值：json-string/json-file/@json-file。

選擇性參數

--dev-center --dev-center-name -d

開發人員中心的名稱。使用 az configure -d dev-center=<dev_center_name> 來設定預設值。

--endpoint

開發人員資源的 API 端點。使用 az configure -d endpoint=<endpoint_uri> 來設定預設值。

全域參數

--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 devcenter dev customization-task

命令

az devcenter dev customization-task list

範例

必要參數

選擇性參數

az devcenter dev customization-task show

範例

必要參數

選擇性參數

az devcenter dev customization-task show-logs

範例

必要參數

選擇性參數

az devcenter dev customization-task validate

範例

必要參數

選擇性參數

其他資源