az devcenter dev customization-group

參考

注意

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

管理自定義群組。

命令

名稱	Description	類型	狀態
az devcenter dev customization-group create	建立自定義群組。	副檔名	GA
az devcenter dev customization-group list	列出開發方塊上的自定義群組。	副檔名	GA
az devcenter dev customization-group show	取得自定義群組。	副檔名	GA

az devcenter dev customization-group create

建立自定義群組。

az devcenter dev customization-group create --customization-group-name
                                            --dev-box
                                            --project
                                            [--dev-center]
                                            [--endpoint]
                                            [--tasks]
                                            [--user-id]

範例

使用開發人員中心建立

az devcenter dev customization-group create --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --tasks "[{\"name\": \"catalogName/choco\", \"displayName\": \"Install VS Code\", \"parameters\": {\"packageName\": \"vscode\", \"packageVersion\": \"1.0.0\"}}, {\"name\": \"catalogName/write-to-file\", \"runAs\": \"User\"}]" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

使用端點建立

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

必要參數

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

自訂群組的名稱。

--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> 來設定預設值。

--tasks

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

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

列出開發方塊上的自定義群組。

az devcenter dev customization-group list --dev-box
                                          --project
                                          [--dev-center]
                                          [--endpoint]
                                          [--include-tasks {false, true}]
                                          [--user-id]

範例

使用開發人員中心列出

az devcenter dev customization-group list --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000" --include-tasks

使用端點列出

az devcenter dev customization-group list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000" --include-tasks

必要參數

--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> 來設定預設值。

--include-tasks

預覽

選擇性參數，以在回應中包含工作資訊。

接受的值: false, true

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

取得自定義群組。

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

範例

使用開發人員中心

az devcenter dev customization-group show --dev-center-name "ContosoDevCenter" --project-name "DevProject" --dev-box-name "myDevBox" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

使用端點

az devcenter dev customization-group show --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --dev-box-name "myDevBox" --name "Provisioning" --user-id "00000000-0000-0000-0000-000000000000"

必要參數

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

自訂群組的名稱。

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

命令

az devcenter dev customization-group create

範例

必要參數

選擇性參數

az devcenter dev customization-group list

範例

必要參數

選擇性參數

az devcenter dev customization-group show

範例

必要參數

選擇性參數

其他資源