Partilhar via


az devcenter dev customization-group

Note

Essa referência faz parte da extensão devcenter para a CLI do Azure (versão 2.67.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az devcenter dev customization-group. Saiba mais sobre extensões.

Gerencie grupos de personalização.

Comandos

Name Description Tipo Status
az devcenter dev customization-group create

Crie um grupo de personalização.

Extension disponibilidade geral
az devcenter dev customization-group list

Liste grupos de personalização na caixa de desenvolvimento.

Extension disponibilidade geral
az devcenter dev customization-group show

Obtenha um grupo de personalização.

Extension disponibilidade geral

az devcenter dev customization-group create

Crie um grupo de personalização.

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

Exemplos

Criar usando o centro de desenvolvimento

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"

Criar usando o ponto de extremidade

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"

Parâmetros Obrigatórios

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

O nome do grupo de personalização.

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

O nome da caixa de desenvolvimento.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrão.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--tasks

Objeto de parâmetros para as tarefas. Valor esperado: json-string/json-file/@json-file.

--user-id

A ID do objeto AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Default value: me
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az devcenter dev customization-group list

Liste grupos de personalização na caixa de desenvolvimento.

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

Exemplos

Lista usando o centro de desenvolvimento

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

Listar usando o ponto de extremidade

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

Parâmetros Obrigatórios

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

O nome da caixa de desenvolvimento.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrão.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--include-tasks

Parâmetro opcional para incluir informações da tarefa na resposta.

Propriedade Valor
Valores aceites: false, true
--user-id

A ID do objeto AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Default value: me
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False

az devcenter dev customization-group show

Obtenha um grupo de personalização.

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

Exemplos

Comece a usar o centro de desenvolvimento

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"

Comece a usar o endpoint

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"

Parâmetros Obrigatórios

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

O nome do grupo de personalização.

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

O nome da caixa de desenvolvimento.

--project --project-name

O nome do projeto. Use az configure -d project=<project_name> para configurar um padrão.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

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

O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.

--endpoint

O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.

--user-id

A ID do objeto AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Default value: me
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade Valor
Default value: False