Partilhar via


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

--add-on-name --name -n

O nome da caixa de desenvolvimento add-on.

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

--hosting-resource-name

O nome do recurso de hospedagem, um DevBox ou HyperV. Deixando-o vazio ou Default se for para DevBox.

Propriedade Valor
Default value: Default
--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--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 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

--add-on-name --name -n

O nome da caixa de desenvolvimento add-on.

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

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--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 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

--add-on-name --name -n

O nome da caixa de desenvolvimento add-on.

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

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--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 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

--add-on-name --name -n

O nome da caixa de desenvolvimento add-on.

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

--no-wait

Não espere que a operação de longa duração termine.

Propriedade Valor
Default value: False
--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 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

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

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

--add-on-name --name -n

O nome da caixa de desenvolvimento add-on.

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