Partilhar via

az lab vm

  • Pré-visualizar
  • Referência

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Gerencie VMs em um azure devtest lab.

Comandos

Name Description Tipo Status
az lab vm apply-artifacts

Aplique artefatos à máquina virtual. Esta operação pode demorar algum tempo a concluir.

 Núcleo Previsualizar
az lab vm claim

Comando para reivindicar uma VM no Azure DevTest Lab.

 Núcleo Previsualizar
az lab vm create

Crie uma VM em um laboratório.

 Núcleo Previsualizar
az lab vm delete

Exclua a máquina virtual. Esta operação pode demorar algum tempo a concluir.

 Núcleo Previsualizar
az lab vm hibernate

Hibernar uma máquina virtual Esta operação pode demorar um pouco para ser concluída.

 Núcleo Previsualizar
az lab vm list

Liste máquinas virtuais em um determinado laboratório.

 Núcleo Previsualizar
az lab vm show

Mostrar máquina virtual.

 Núcleo Previsualizar
az lab vm start

Inicie uma máquina virtual. Esta operação pode demorar algum tempo a concluir.

 Núcleo Previsualizar
az lab vm stop

Parar uma máquina virtual Esta operação pode demorar um pouco para ser concluída.

 Núcleo Previsualizar
az lab vm wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Núcleo Previsualizar

az lab vm apply-artifacts

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Aplique artefatos à máquina virtual. Esta operação pode demorar algum tempo a concluir.

az lab vm apply-artifacts --lab-name
                          --name
                          --resource-group
                          [--artifacts]
                          [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Exemplos

Aplique artefatos a uma máquina virtual no Azure DevTest Lab.

az lab vm apply-artifacts --artifacts artifacts.json --lab-name MyLab --name MyVirtualMachine --resource-group MyResourceGroup

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name -n

O nome da máquina virtual.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--artifacts

Caminho para a matriz codificada JSON de artefatos a serem aplicados. Lista codificada de parâmetros JSON.

--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm claim

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Comando para reivindicar uma VM no Azure DevTest Lab.

az lab vm claim [--ids]
                [--lab-name]
                [--name]
                [--resource-group]
                [--subscription]

Parâmetros Opcionais

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--lab-name

Nome do laboratório.

--name -n

Nome da máquina virtual a ser declarada.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm create

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Crie uma VM em um laboratório.

az lab vm create --lab-name
                 --name
                 --resource-group
                 [--admin-password]
                 [--admin-username]
                 [--allow-claim {0, 1, f, false, n, no, t, true, y, yes}]
                 [--artifacts]
                 [--authentication-type {password, ssh}]
                 [--disk-type {Premium, Standard, StandardSSD}]
                 [--expiration-date]
                 [--formula]
                 [--generate-ssh-keys {0, 1, f, false, n, no, t, true, y, yes}]
                 [--image]
                 [--image-type {custom, gallery}]
                 [--ip-configuration {private, public, shared}]
                 [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                 [--notes]
                 [--saved-secret]
                 [--size]
                 [--ssh-key]
                 [--subnet]
                 [--tags]
                 [--vnet-name]

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name -n

O nome da máquina virtual ou do ambiente.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--admin-password

Senha para o administrador da VM.

--admin-username

Nome de usuário para o administrador da VM.

Default value: your_system_user_login_name
--allow-claim

Sinalizador que indica se a VM deve ser criada como reclamável.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Default value: False
--artifacts

Caminho para a matriz codificada JSON de artefatos a serem aplicados. Lista codificada de parâmetros JSON.

--authentication-type

Tipo de autenticação permitido para a VM.

Valores aceites: password, ssh
Default value: password
--disk-type

Tipo de armazenamento a ser usado para máquina virtual.

Valores aceites: Premium, Standard, StandardSSD
--expiration-date

A data de expiração da VM.

--formula

Nome da fórmula. Use az lab formula list para fórmulas disponíveis. Use az lab formula com o sinalizador --export-artifacts para exportar e atualizar artefatos e, em seguida, passe os resultados por meio do argumento --artifacts.

--generate-ssh-keys

Gere arquivos de chave pública e privada SSH, se faltar.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--image

O nome da imagem do sistema operacional (nome da imagem da galeria ou nome/ID da imagem personalizada). Use az lab gallery-image list para imagens de galeria disponíveis ou az lab custom-image list para imagens personalizadas disponíveis.

--image-type

Tipo de imagem.

Valores aceites: custom, gallery
--ip-configuration

Tipo de configuração IP a ser usada para a VM.

Valores aceites: private, public, shared
--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--notes

As notas da máquina virtual.

--saved-secret

Nome do segredo salvo a ser usado para autenticação. Quando esse valor é fornecido, ele é usado no lugar de outros métodos de autenticação.

--size

O tamanho da VM a ser criada. Consulte https://azure.microsoft.com/pricing/details/virtual-machines/ para obter informações sobre o tamanho.

--ssh-key

A chave pública SSH ou o caminho do arquivo de chave pública. Use --generate-ssh-keys para gerar chaves SSH.

--subnet

Nome da sub-rede à qual adicionar a VM.

--tags

As tags do recurso. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--vnet-name

Nome da rede virtual à qual adicionar a VM.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm delete

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Exclua a máquina virtual. Esta operação pode demorar algum tempo a concluir.

az lab vm delete --lab-name
                 --name
                 --resource-group
                 [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                 [--yes]

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm hibernate

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Hibernar uma máquina virtual Esta operação pode demorar um pouco para ser concluída.

az lab vm hibernate --lab-name
                    --name
                    --resource-group
                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Exemplos

Hibernar uma máquina virtual.

az lab vm hibernate --resource-group MyResourceGroup --lab-name MyLab --name MyVM

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm list

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Liste máquinas virtuais em um determinado laboratório.

az lab vm list --lab-name
               --resource-group
               [--all {0, 1, f, false, n, no, t, true, y, yes}]
               [--claimable {0, 1, f, false, n, no, t, true, y, yes}]
               [--environment]
               [--expand]
               [--filters]
               [--max-items]
               [--next-token]
               [--object-id]
               [--order-by]
               [--top]

Exemplos

Liste as VMs em um Azure DevTest Lab.

az lab vm list --lab-name MyLab --resource-group MyResourceGroup

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--all

Liste todas as máquinas virtuais no laboratório. Não pode ser utilizado com --filters.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--claimable

Liste apenas máquinas virtuais reivindicáveis no laboratório. Não pode ser utilizado com --filters.

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--environment

Nome ou ID do ambiente no qual listar máquinas virtuais. Não pode ser utilizado com --filters.

--expand

Especifique o $expand consulta. Exemplo: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'.

--filters

O filtro a ser aplicado à operação. Exemplo: '$filter=contém(nome,'meuNome').

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token em --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

--object-id

ID do objeto do proprietário para listar VMs.

--order-by

A expressão de ordenação para os resultados, usando notação OData. Exemplo: '$orderby=name desc'.

--top

O número máximo de recursos a serem retornados da operação. Exemplo: '$top=10'.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm show

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Mostrar máquina virtual.

az lab vm show --lab-name
               --name
               --resource-group
               [--expand]

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--expand

Especifique o $expand consulta. Exemplo: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm start

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Inicie uma máquina virtual. Esta operação pode demorar algum tempo a concluir.

az lab vm start --lab-name
                --name
                --resource-group
                [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm stop

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Parar uma máquina virtual Esta operação pode demorar um pouco para ser concluída.

az lab vm stop --lab-name
               --name
               --resource-group
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

--no-wait

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

Valores aceites: 0, 1, f, false, n, no, t, true, y, yes
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az lab vm wait

Editar
Pré-visualizar

O grupo de comando 'lab' está em pré-visualização e em desenvolvimento. Níveis de referência e apoio: https://aka.ms/CLI_refstatus

Coloque a CLI em um estado de espera até que uma condição seja atendida.

az lab vm wait [--created]
               [--custom]
               [--deleted]
               [--exists]
               [--expand]
               [--ids]
               [--interval]
               [--lab-name]
               [--name]
               [--resource-group]
               [--subscription]
               [--timeout]
               [--updated]

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Default value: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--expand

Especifique o $expand consulta. Exemplo: 'properties($expand=artifacts,computeVm,networkInterface,applicableSchedule)'.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

Default value: 30
--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

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

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.