你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az devcenter dev customization-group

参考

注意

此参考是 Azure CLI（版本 2.67.0 或更高版本）的 开发中心 扩展的一部分。该扩展会在首次运行 az devcenter dev customization-group 命令时自动安装。详细了解扩展。

管理自定义组。

命令

名称	说明	类型	Status
az devcenter dev customization-group create	创建自定义组。	外延	加语
az devcenter dev customization-group list	列出开发框中的自定义组。	外延	加语
az devcenter dev customization-group show	获取自定义组。	外延	加语

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 对象 ID。如果值为“me”，则标识取自身份验证上下文。

默认值: me

全局参数

--debug

增加日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。有关详细信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 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 对象 ID。如果值为“me”，则标识取自身份验证上下文。

默认值: me

全局参数

--debug

增加日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。有关详细信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 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 对象 ID。如果值为“me”，则标识取自身份验证上下文。

默认值: me

全局参数

--debug

增加日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

仅显示错误，禁止显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。有关详细信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 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

示例

必需参数

可选参数

其他资源