Compartilhar via


az devcenter dev dev-box

Note

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

Gerenciar caixas de desenvolvimento.

Comandos

Nome Description Tipo Status
az devcenter dev dev-box align

Alinhe uma caixa de desenvolvimento à configuração atual do pool de pools.

Extension GA
az devcenter dev dev-box approve

Aprove a criação de uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box capture-snapshot

Captura um instantâneo manual da caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box create

Crie uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box delay-action

Atrase uma ação.

Extension GA
az devcenter dev dev-box delay-all-actions

Atrase todas as ações.

Extension GA
az devcenter dev dev-box delete

Excluir uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box list

Listar caixas de desenvolvimento para um usuário, listar caixas de desenvolvimento no centro de desenvolvimento para um projeto e usuário ou listar caixas de desenvolvimento às quais o chamador tem acesso no centro de desenvolvimento.

Extension GA
az devcenter dev dev-box list-action

Listar ações em uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box list-operation

Lista as operações na caixa de desenvolvimento que ocorreram nos últimos 90 dias.

Extension GA
az devcenter dev dev-box list-snapshot

Liste instantâneos para uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box repair

Tenta etapas de reparo automatizado para resolver problemas comuns em uma Caixa de Desenvolvimento. A caixa de desenvolvimento pode ser reiniciada durante essa operação.

Extension GA
az devcenter dev dev-box restart

Reinicie uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box restore-snapshot

Restaura uma caixa de desenvolvimento para um instantâneo especificado.

Extension GA
az devcenter dev dev-box schedule-delete

Cria uma ação para agendar a exclusão de uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box set-active-hours

Permite que um usuário defina suas próprias horas ativas para seu Dev Box, substituindo os padrões definidos no nível do pool.

Extension GA
az devcenter dev dev-box show

Obtenha uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box show-action

Obtenha uma ação.

Extension GA
az devcenter dev dev-box show-operation

Obtenha uma operação em uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box show-remote-connection

Obtenha informações de conexão remota.

Extension GA
az devcenter dev dev-box show-snapshot

Obtenha um instantâneo por ID de instantâneo.

Extension GA
az devcenter dev dev-box skip-action

Ignore uma ação.

Extension GA
az devcenter dev dev-box start

Inicie uma caixa de desenvolvimento.

Extension GA
az devcenter dev dev-box stop

Pare uma caixa de desenvolvimento.

Extension GA

az devcenter dev dev-box align

Alinhe uma caixa de desenvolvimento à configuração atual do pool de pools.

az devcenter dev dev-box align --dev-box-name --name
                               --project --project-name
                               --targets
                               [--dev-center --dev-center-name]
                               [--endpoint]
                               [--no-wait]
                               [--user-id]

Exemplos

Alinhar usando o centro de desenvolvimento

az devcenter dev dev-box align --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --targets NetworkProperties HibernateSupport

Alinhar usando o ponto de extremidade

az devcenter dev dev-box align --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --targets NetworkProperties HibernateSupport

Parâmetros Exigidos

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

O nome de uma caixa de desenvolvimento.

--project --project-name

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

--targets

Configurações separadas por espaço para alinhar. Os valores possíveis são "NetworkProperties", "HibernateSupport" ou "SingleSignOnStatus".

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box approve

Aprove a criação de uma caixa de desenvolvimento.

az devcenter dev dev-box approve --dev-box-name --name
                                 --project --project-name
                                 --user-id
                                 [--dev-center --dev-center-name]
                                 [--endpoint]
                                 [--no-wait]

Exemplos

Aprovar usando o centro de desenvolvimento

az devcenter dev dev-box approve --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Aprovar usando o ponto de extremidade

az devcenter dev dev-box approve --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 Exigidos

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

O nome de uma caixa de desenvolvimento.

--project --project-name

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

--user-id

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box capture-snapshot

Captura um instantâneo manual da caixa de desenvolvimento.

az devcenter dev dev-box capture-snapshot --dev-box-name --name
                                          --project --project-name
                                          [--dev-center --dev-center-name]
                                          [--endpoint]
                                          [--no-wait]
                                          [--user-id]

Exemplos

Capturar instantâneo usando o centro de desenvolvimento

az devcenter dev dev-box capture-snapshot --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Capturar instantâneo usando o ponto de extremidade

az devcenter dev dev-box capture-snapshot --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box create

Crie uma caixa de desenvolvimento.

az devcenter dev dev-box create --dev-box-name --name
                                --pool --pool-name
                                --project --project-name
                                [--dev-center --dev-center-name]
                                [--endpoint]
                                [--no-wait]
                                [--user-id]

Exemplos

Criar usando o centro de desenvolvimento

az devcenter dev dev-box create --pool-name "LargeDevWorkStationPool" --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Criar usando o ponto de extremidade

az devcenter dev dev-box create --pool-name "LargeDevWorkStationPool" --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 Exigidos

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

O nome de uma caixa de desenvolvimento.

--pool --pool-name

O nome do pool de caixas de desenvolvimento ao qual este computador pertence.

--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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box delay-action

Atrase uma ação.

az devcenter dev dev-box delay-action --action-name
                                      --delay-time
                                      --dev-box-name --name
                                      --project --project-name
                                      [--dev-center --dev-center-name]
                                      [--endpoint]
                                      [--user-id]

Exemplos

Atrasar a ação usando o centro de desenvolvimento

az devcenter dev dev-box delay-action --dev-center-name "ContosoDevCenter" --project-name "DevProject" --delay-time "04:30" --name "myDevBox" --action-name "schedule-default" --user-id "00000000-0000-0000-0000-000000000000"

Atrasar a ação usando o ponto de extremidade

az devcenter dev dev-box delay-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --delay-time "04:30" --name "myDevBox" --action-name "schedule-default" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--action-name

O nome de uma ação que ocorrerá em uma caixa de desenvolvimento.

--delay-time

O tempo limite atrasado da hora de ação agendada. Formatar HH:MM.

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box delay-all-actions

Atrase todas as ações.

az devcenter dev dev-box delay-all-actions --delay-time
                                           --dev-box-name --name
                                           --project --project-name
                                           [--dev-center --dev-center-name]
                                           [--endpoint]
                                           [--user-id]

Exemplos

Atrasar todas as ações usando o centro de desenvolvimento

az devcenter dev dev-box delay-all-actions --dev-center-name "ContosoDevCenter" --project-name "DevProject" --delay-time "04:30" --name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000"

Atrasar todas as ações usando o ponto de extremidade

az devcenter dev dev-box delay-all-actions --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --delay-time "04:30" --name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--delay-time

O tempo limite atrasado do horário agendado mais antigo de todas as ações. Formatar HH:MM.

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box delete

Excluir uma caixa de desenvolvimento.

az devcenter dev dev-box delete --dev-box-name --name
                                --project --project-name
                                [--dev-center --dev-center-name]
                                [--endpoint]
                                [--no-wait]
                                [--user-id]
                                [--yes]

Exemplos

Excluir usando o centro de desenvolvimento

az devcenter dev dev-box delete --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Excluir usando o ponto de extremidade

az devcenter dev dev-box delete --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
--yes -y

Não solicite confirmação.

Propriedade Valor
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box list

Listar caixas de desenvolvimento para um usuário, listar caixas de desenvolvimento no centro de desenvolvimento para um projeto e usuário ou listar caixas de desenvolvimento às quais o chamador tem acesso no centro de desenvolvimento.

az devcenter dev dev-box list [--dev-center --dev-center-name]
                              [--endpoint]
                              [--project --project-name]
                              [--user-id]

Exemplos

Listar todas as caixas de desenvolvimento no centro de desenvolvimento

az devcenter dev dev-box list --dev-center-name "ContosoDevCenter"

Listar todas as caixas de desenvolvimento no centro de desenvolvimento usando o ponto de extremidade

az devcenter dev dev-box list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/"

Listar por usuário usando o centro de desenvolvimento

az devcenter dev dev-box list --dev-center-name "ContosoDevCenter" --user-id "00000000-0000-0000-0000-000000000000"

Listar por usuário usando o ponto de extremidade

az devcenter dev dev-box list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --user-id "00000000-0000-0000-0000-000000000000"

Listar por usuário e projeto usando o centro de desenvolvimento

az devcenter dev dev-box list --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Listar por usuário e projeto usando o ponto de extremidade

az devcenter dev dev-box list --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

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

--project --project-name

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

--user-id

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box list-action

Listar ações em uma caixa de desenvolvimento.

az devcenter dev dev-box list-action --dev-box-name --name
                                     --project --project-name
                                     [--dev-center --dev-center-name]
                                     [--endpoint]
                                     [--user-id]

Exemplos

Listar ações usando o centro de desenvolvimento

az devcenter dev dev-box list-action --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000"

Listar ações usando o ponto de extremidade

az devcenter dev dev-box list-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box list-operation

Lista as operações na caixa de desenvolvimento que ocorreram nos últimos 90 dias.

az devcenter dev dev-box list-operation --dev-box-name --name
                                        --project --project-name
                                        [--dev-center --dev-center-name]
                                        [--endpoint]
                                        [--user-id]

Exemplos

Listar operações usando o centro de desenvolvimento

az devcenter dev dev-box list-operation --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000"

Listar operações usando o ponto de extremidade

az devcenter dev dev-box list-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "myDevBox" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box list-snapshot

Liste instantâneos para uma caixa de desenvolvimento.

az devcenter dev dev-box list-snapshot --dev-box-name --name
                                       --project --project-name
                                       [--dev-center --dev-center-name]
                                       [--endpoint]
                                       [--user-id]

Exemplos

Listar instantâneos usando o centro de desenvolvimento

az devcenter dev dev-box list-snapshot --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Listar instantâneos usando o ponto de extremidade

az devcenter dev dev-box list-snapshot --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box repair

Tenta etapas de reparo automatizado para resolver problemas comuns em uma Caixa de Desenvolvimento. A caixa de desenvolvimento pode ser reiniciada durante essa operação.

az devcenter dev dev-box repair --dev-box-name --name
                                --project --project-name
                                [--dev-center --dev-center-name]
                                [--endpoint]
                                [--no-wait]
                                [--user-id]

Exemplos

Reparar usando o centro de desenvolvimento

az devcenter dev dev-box repair --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Reparar usando o ponto de extremidade

az devcenter dev dev-box repair --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box restart

Reinicie uma caixa de desenvolvimento.

az devcenter dev dev-box restart --dev-box-name --name
                                 --project --project-name
                                 [--dev-center --dev-center-name]
                                 [--endpoint]
                                 [--no-wait]
                                 [--user-id]

Exemplos

Reiniciar usando o centro de desenvolvimento

az devcenter dev dev-box restart --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Reiniciar usando o ponto de extremidade

az devcenter dev dev-box restart --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box restore-snapshot

Restaura uma caixa de desenvolvimento para um instantâneo especificado.

az devcenter dev dev-box restore-snapshot --dev-box-name --name
                                          --project --project-name
                                          --snapshot-id
                                          [--dev-center --dev-center-name]
                                          [--endpoint]
                                          [--no-wait]
                                          [--user-id]

Exemplos

Restaurar instantâneo usando o centro de desenvolvimento

az devcenter dev dev-box restore-snapshot --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --snapshot-id "CPC_f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Restaurar instantâneo usando o ponto de extremidade

az devcenter dev dev-box restore-snapshot --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --snapshot-id "CPC_f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Parâmetros Exigidos

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

O nome de uma caixa de desenvolvimento.

--project --project-name

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

--snapshot-id -s

Parâmetro necessário que especifica a ID de instantâneo a ser usada para a operação de restauração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box schedule-delete

Cria uma ação para agendar a exclusão de uma caixa de desenvolvimento.

az devcenter dev dev-box schedule-delete --delete-at
                                         --dev-box-name --name
                                         --project --project-name
                                         [--dev-center --dev-center-name]
                                         [--endpoint]
                                         [--user-id]

Exemplos

Agendar exclusão usando o centro de desenvolvimento

az devcenter dev dev-box schedule-delete --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --delete-at "2027-12-31T23:59:00Z"

Agendar exclusão usando o ponto de extremidade

az devcenter dev dev-box schedule-delete --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --delete-at "2027-12-31T23:59:00Z"

Parâmetros Exigidos

--delete-at

A hora de exclusão agendada do Computador de Desenvolvimento, no formato RFC3339.

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box set-active-hours

Permite que um usuário defina suas próprias horas ativas para seu Dev Box, substituindo os padrões definidos no nível do pool.

az devcenter dev dev-box set-active-hours --dev-box-name --name
                                          --end-time-hour
                                          --project --project-name
                                          --start-time-hour
                                          --time-zone
                                          [--days-of-week]
                                          [--dev-center --dev-center-name]
                                          [--endpoint]
                                          [--user-id]

Exemplos

Definir horas ativas usando o centro de desenvolvimento

az devcenter dev dev-box set-active-hours --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --time-zone "America/Los_Angeles" --start-time-hour "9" --end-time-hour "17" --days-of-week Monday Tuesday Wednesday Thursday Friday

Definir horas ativas usando o ponto de extremidade

az devcenter dev dev-box set-active-hours --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --time-zone "America/Los_Angeles" --start-time-hour "9" --end-time-hour "17" --days-of-week Monday Tuesday Wednesday Thursday Friday

Parâmetros Exigidos

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

O nome de uma caixa de desenvolvimento.

--end-time-hour

A hora de término do horário ativo.

--project --project-name

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

--start-time-hour

A hora de início das horas ativas.

--time-zone

O fuso horário do horário ativo.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--days-of-week

Espaço separado dias da semana para o horário ativo. Os valores possíveis são "Segunda", "Terça", "Quarta", "Quinta", "Sexta", "Sábado", "Domingo".

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box show

Obtenha uma caixa de desenvolvimento.

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

Exemplos

Obter usando o centro de desenvolvimento

az devcenter dev dev-box show --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Usar o ponto de extremidade

az devcenter dev dev-box show --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box show-action

Obtenha uma ação.

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

Exemplos

Obter ação usando o centro de desenvolvimento

az devcenter dev dev-box show-action --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "myDevBox" --action-name "schedule-default" --user-id "00000000-0000-0000-0000-000000000000"

Obter ação usando o ponto de extremidade

az devcenter dev dev-box show-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "myDevBox" --action-name "schedule-default" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--action-name

O nome de uma ação que ocorrerá em uma caixa de desenvolvimento.

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box show-operation

Obtenha uma operação em uma caixa de desenvolvimento.

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

Exemplos

Obter operação usando o centro de desenvolvimento

az devcenter dev dev-box show-operation --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "myDevBox" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680" --user-id "00000000-0000-0000-0000-000000000000"

Obter operação usando o ponto de extremidade

az devcenter dev dev-box show-operation --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "myDevBox" --operation-id "f5dbdfab-fa0e-4831-8d13-25359aa5e680" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

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

O nome de uma caixa de desenvolvimento.

--operation-id

A ID da operação em uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box show-remote-connection

Obtenha informações de conexão remota.

az devcenter dev dev-box show-remote-connection --dev-box-name --name
                                                --project --project-name
                                                [--dev-center --dev-center-name]
                                                [--endpoint]
                                                [--user-id]

Exemplos

Obter conexão remota usando o centro de desenvolvimento

az devcenter dev dev-box show-remote-connection --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Obter conexão remota usando o centro de desenvolvimento

az devcenter dev dev-box show-remote-connection --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box show-snapshot

Obtenha um instantâneo por ID de instantâneo.

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

Exemplos

Obter instantâneo usando o centro de desenvolvimento

az devcenter dev dev-box show-snapshot --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --snapshot-id "CPC_f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Obter instantâneo usando o ponto de extremidade

az devcenter dev dev-box show-snapshot --name "MyDevBox" --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000" --snapshot-id "CPC_f5dbdfab-fa0e-4831-8d13-25359aa5e680"

Parâmetros Exigidos

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

O nome de uma caixa de desenvolvimento.

--project --project-name

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

--snapshot-id -s

Parâmetro necessário que especifica a ID de instantâneo a ser usada para a operação de restauração.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box skip-action

Ignore uma ação.

az devcenter dev dev-box skip-action --action-name
                                     --dev-box-name --name
                                     --project --project-name
                                     [--dev-center --dev-center-name]
                                     [--endpoint]
                                     [--user-id]

Exemplos

Ignorar a ação usando o centro de desenvolvimento

az devcenter dev dev-box skip-action --dev-center-name "ContosoDevCenter" --project-name "DevProject" --name "myDevBox" --action-name "schedule-default" --user-id "00000000-0000-0000-0000-000000000000"

Ignorar a ação usando o ponto de extremidade

az devcenter dev dev-box skip-action --endpoint "https://8a40af38-3b4c-4672-a6a4-5e964b1870ed-contosodevcenter.centralus.devcenter.azure.com/" --project-name "DevProject" --name "myDevBox" --action-name "schedule-default" --user-id "00000000-0000-0000-0000-000000000000"

Parâmetros Exigidos

--action-name

O nome de uma ação que ocorrerá em uma caixa de desenvolvimento.

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 de objeto do AAD do usuário. Se o valor for 'me', a identidade será retirada do contexto de autenticação.

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box start

Inicie uma caixa de desenvolvimento.

az devcenter dev dev-box start --dev-box-name --name
                               --project --project-name
                               [--dev-center --dev-center-name]
                               [--endpoint]
                               [--no-wait]
                               [--user-id]

Exemplos

Começar a usar o centro de desenvolvimento

az devcenter dev dev-box start --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Começar a usar o ponto de extremidade

az devcenter dev dev-box start --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

--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 aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az devcenter dev dev-box stop

Pare uma caixa de desenvolvimento.

az devcenter dev dev-box stop --dev-box-name --name
                              --project --project-name
                              [--dev-center --dev-center-name]
                              [--endpoint]
                              [--hibernate {false, true}]
                              [--no-wait]
                              [--user-id]

Exemplos

Parar de usar o centro de desenvolvimento

az devcenter dev dev-box stop --name "MyDevBox" --dev-center-name "ContosoDevCenter" --project-name "DevProject" --user-id "00000000-0000-0000-0000-000000000000"

Parar de usar o ponto de extremidade

az devcenter dev dev-box stop --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 Exigidos

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

O nome de uma 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 se tornar obrigatórios para que o comando seja executado com sucesso.

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

--hibernate

Parâmetro opcional para hibernar a caixa de desenvolvimento.

Propriedade Valor
Valores aceitos: false, true
--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade Valor
Valor padrão: False
--user-id

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

Propriedade Valor
Valor padrão: me
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False