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

az devcenter dev customization-task

参考

注意

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

管理自定义任务。

命令

名称	说明	类型	Status
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	验证自定义任务。	外延	加语

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

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID配置默认订阅。

--verbose

增加日志记录详细程度。对完整调试日志使用 --debug。

az devcenter dev customization-task show

获取自定义任务。

az devcenter dev customization-task show --catalog-name
                                         --name
                                         --project
                                         [--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

目录的名称。

--name --task-name -n

任务的名称。

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

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

验证自定义任务。

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

示例

使用开发人员中心进行验证

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> 配置默认值。

--no-wait

不要等待长时间运行的操作完成。

默认值: False

全局参数

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

示例

必需参数

可选参数

其他资源