az devcenter dev add-on
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 add-on . Saiba mais sobre extensões.
Gerencie complementos.
Comandos
| Name | Description | Tipo | Status |
|---|---|---|---|
| az devcenter dev add-on create |
Crie um complemento de caixa de desenvolvimento. |
Extension | disponibilidade geral |
| az devcenter dev add-on delete |
Exclua um complemento de caixa de desenvolvimento. |
Extension | disponibilidade geral |
| az devcenter dev add-on disable |
Desative um complemento de caixa de desenvolvimento. |
Extension | disponibilidade geral |
| az devcenter dev add-on enable |
Habilite um complemento de caixa de desenvolvimento. |
Extension | disponibilidade geral |
| az devcenter dev add-on list |
Listar complementos para uma caixa de desenvolvimento. |
Extension | disponibilidade geral |
| az devcenter dev add-on show |
Obtenha um complemento de caixa de desenvolvimento. |
Extension | disponibilidade geral |
az devcenter dev add-on create
Crie um complemento de caixa de desenvolvimento.
az devcenter dev add-on create --add-on-name --name
--dev-box --dev-box-name
--project --project-name
[--dev-center --dev-center-name]
[--endpoint]
[--hosting-resource-name]
[--no-wait]
[--user-id]
Exemplos
Criar usando o centro de desenvolvimento
az devcenter dev add-on create --dev-box-name "myDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Criar usando o ponto de extremidade
az devcenter dev add-on create --dev-box-name "myDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Parâmetros Obrigatórios
O nome da caixa de desenvolvimento add-on.
O nome da caixa de desenvolvimento.
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.
O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.
O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.
O nome do recurso de hospedagem, um DevBox ou HyperV. Deixando-o vazio ou Default se for para DevBox.
| Propriedade | Valor |
|---|---|
| Default value: | Default |
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devcenter dev add-on delete
Exclua um complemento de caixa de desenvolvimento.
az devcenter dev add-on delete --add-on-name --name
--dev-box --dev-box-name
--project --project-name
[--dev-center --dev-center-name]
[--endpoint]
[--no-wait]
[--user-id]
Exemplos
Excluir usando o centro de desenvolvimento
az devcenter dev add-on delete --dev-box-name "myDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Excluir usando o ponto de extremidade
az devcenter dev add-on delete --dev-box-name "myDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Parâmetros Obrigatórios
O nome da caixa de desenvolvimento add-on.
O nome da caixa de desenvolvimento.
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.
O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.
O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devcenter dev add-on disable
Desative um complemento de caixa de desenvolvimento.
az devcenter dev add-on disable --add-on-name --name
--dev-box --dev-box-name
--project --project-name
[--dev-center --dev-center-name]
[--endpoint]
[--no-wait]
[--user-id]
Exemplos
Desativar usando o centro de desenvolvimento
az devcenter dev add-on disable --dev-box-name "myDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Desativar o uso do ponto de extremidade
az devcenter dev add-on disable --dev-box-name "myDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Parâmetros Obrigatórios
O nome da caixa de desenvolvimento add-on.
O nome da caixa de desenvolvimento.
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.
O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.
O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devcenter dev add-on enable
Habilite um complemento de caixa de desenvolvimento.
az devcenter dev add-on enable --add-on-name --name
--dev-box --dev-box-name
--project --project-name
[--dev-center --dev-center-name]
[--endpoint]
[--no-wait]
[--user-id]
Exemplos
Habilitar o uso do centro de desenvolvimento
az devcenter dev add-on enable --dev-box-name "myDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Habilitar o uso do ponto de extremidade
az devcenter dev add-on enable --dev-box-name "myDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Parâmetros Obrigatórios
O nome da caixa de desenvolvimento add-on.
O nome da caixa de desenvolvimento.
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.
O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.
O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.
Não espere que a operação de longa duração termine.
| Propriedade | Valor |
|---|---|
| Default value: | False |
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devcenter dev add-on list
Listar complementos para uma caixa de desenvolvimento.
az devcenter dev add-on list --dev-box --dev-box-name
--project --project-name
[--dev-center --dev-center-name]
[--endpoint]
[--user-id]
Exemplos
Lista usando o centro de desenvolvimento
az devcenter dev add-on list --dev-box-name "myDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
Listar usando o ponto de extremidade
az devcenter dev add-on list --dev-box-name "myDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"
Parâmetros Obrigatórios
O nome da caixa de desenvolvimento.
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.
O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.
O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
az devcenter dev add-on show
Obtenha um complemento de caixa de desenvolvimento.
az devcenter dev add-on show --add-on-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 add-on show --dev-box-name "myDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Comece a usar o endpoint
az devcenter dev add-on show --dev-box-name "myDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --add-on-name "devboxtunnel-sys-default"
Parâmetros Obrigatórios
O nome da caixa de desenvolvimento add-on.
O nome da caixa de desenvolvimento.
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.
O nome do centro de desenvolvimento. Use az configure -d dev-center=<dev_center_name> para configurar um padrão.
O ponto de extremidade da API para os recursos do desenvolvedor. Use az configure -d endpoint=<endpoint_uri> para configurar um padrão.
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
Aumente a verbosidade do log para mostrar todos os logs de depuração.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Mostrar esta mensagem de ajuda e sair.
Mostrar apenas erros, suprimindo avisos.
| Propriedade | Valor |
|---|---|
| Default value: | False |
Formato de saída.
| Propriedade | Valor |
|---|---|
| Default value: | json |
| Valores aceites: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.
Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.
Aumente a verbosidade do registro. Use --debug para logs de depuração completos.
| Propriedade | Valor |
|---|---|
| Default value: | False |