Share 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 de apoio: https://aka.ms/CLI_refstatus

Gerencie VMs em um Azure DevTest Lab.

Comandos

Name Description Tipo Estado
az lab vm apply-artifacts

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

 Principal Pré-visualizar
az lab vm claim

Reivindicar uma máquina virtual do laboratório.

 Principal Pré-visualizar
az lab vm create

Crie uma VM em um laboratório.

 Principal Pré-visualizar
az lab vm delete

Exclua a máquina virtual.

 Principal Pré-visualizar
az lab vm list

Liste as VMs em um Azure DevTest Lab.

 Principal Pré-visualizar
az lab vm show

Obtenha a máquina virtual.

 Principal Pré-visualizar
az lab vm start

Inicie uma máquina virtual.

 Principal Pré-visualizar
az lab vm stop

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

 Principal Pré-visualizar

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 de apoio: https://aka.ms/CLI_refstatus

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

az lab vm apply-artifacts --lab-name
                          --name
                          --resource-group
                          [--artifacts]

Exemplos

Aplique artefatos a uma máquina virtual no Azure DevTest Lab. (gerado automaticamente)

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

Parâmetros Obrigatórios

--lab-name

Nome do laboratório.

--name -n

Nome da máquina virtual.

--resource-group -g

Nome do grupo de recursos do laboratório.

Parâmetros Opcionais

--artifacts

Matriz codificada JSON de artefatos a serem aplicados. Use '@{file}' para carregar a partir de um arquivo.

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
valor predefinido: json
--query

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

--subscription

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

--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 de apoio: https://aka.ms/CLI_refstatus

Reivindicar uma máquina virtual do laboratório.

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

Exemplos

Reivindique qualquer máquina virtual disponível no laboratório.

az lab vm claim -g {ResourceGroup} --lab-name {LabName}

Reivindicar uma máquina virtual específica no laboratório.

az lab vm claim -g {ResourceGroup} --lab-name {LabName} --name {VMName}

Reivindicar várias máquinas virtuais no laboratório por IDs.

az lab vm claim --ids \
    /subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName1} \
    /subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName2}

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 do laboratório.

--subscription

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

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
valor predefinido: json
--query

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

--subscription

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

--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 de 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]
                 [--artifacts]
                 [--authentication-type]
                 [--disk-type]
                 [--expiration-date]
                 [--formula]
                 [--generate-ssh-keys]
                 [--image]
                 [--image-type]
                 [--ip-configuration]
                 [--notes]
                 [--saved-secret]
                 [--size]
                 [--ssh-key]
                 [--subnet]
                 [--tags]
                 [--vnet-name]

Exemplos

Crie uma VM no laboratório a partir de uma imagem de galeria.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2

Crie uma VM no laboratório a partir de uma imagem de galeria com autenticação SSH.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --authentication-type ssh

Crie uma VM reivível no laboratório a partir de uma imagem de galeria com autenticação de senha.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --allow-claim

Crie uma VM do Windows no laboratório a partir de uma imagem de galeria com autenticação de senha.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Windows Server 2008 R2 SP1" --image-type gallery --size Standard_DS1_v2

Crie uma VM no laboratório a partir de uma imagem personalizada.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "jenkins_custom" --image-type custom --size Standard_DS1_v2

Crie uma VM no laboratório com um IP público.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --image "Ubuntu Server 16.04 LTS" --image-type gallery --size Standard_DS1_v2 --ip-configuration public

Crie uma VM a partir de uma fórmula.

az lab vm create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --formula MyFormula --artifacts '@artifacts.json'

Parâmetros Obrigatórios

--lab-name

Nome do laboratório.

--name -n

Nome da máquina virtual.

--resource-group -g

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

valor predefinido: your_system_user_login_name
--allow-claim

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

valor predefinido: False
--artifacts

Matriz codificada JSON de artefatos a serem aplicados. Use '@{file}' para carregar a partir de um arquivo.

--authentication-type

Tipo de autenticação permitido para a VM. Os valores permitidos são: password, ssh.

valor predefinido: password
--disk-type

Tipo de armazenamento a ser usado para máquina virtual. Os valores permitidos são: Premium, Standard, StandardSSD.

--expiration-date

A data de expiração em UTC(aaaa-MM-ddTHH:mm:ss) para a VM.

--formula

Nome da fórmula. Use az lab formula list para fórmulas disponíveis.

Use az lab formula com o --export-artifacts sinalizador para exportar e atualizar artefatos e, em seguida, passe os resultados por meio do --artifacts argumento.

--generate-ssh-keys

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

--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. Os valores permitidos são: galeria, personalizado.

--ip-configuration

Tipo de configuração IP a ser usada para a VM. Os valores permitidos são: compartilhado, público, privado.

Se omitido, será selecionado com base na vnet da VM.

--notes

Notas para a 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

Tags separadas por espaço no key[=value] formato.

As tags podem ser limpas atribuindo o valor vazio "" a elas.

--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
valor predefinido: json
--query

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

--subscription

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

--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 de apoio: https://aka.ms/CLI_refstatus

Exclua a máquina virtual.

Esta operação pode demorar algum tempo.

az lab vm delete --lab-name
                 --name
                 --resource-group

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

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

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
valor predefinido: json
--query

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

--subscription

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

--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 de apoio: https://aka.ms/CLI_refstatus

Liste as VMs em um Azure DevTest Lab.

az lab vm list --lab-name
               --resource-group
               [--all]
               [--claimable]
               [--environment]
               [--expand]
               [--filters]
               [--object-id]
               [--order-by]
               [--top]

Exemplos

Liste as VMs em um Azure DevTest Lab. (gerado automaticamente)

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

Parâmetros Obrigatórios

--lab-name

Nome do laboratório.

--resource-group -g

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

--claimable

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

--environment

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

--expand

A consulta expandir.

--filters

O filtro a ser aplicado.

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

--top

O número máximo de recursos a serem retornados.

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
valor predefinido: json
--query

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

--subscription

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

--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 de apoio: https://aka.ms/CLI_refstatus

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

o 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
valor predefinido: json
--query

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

--subscription

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

--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 de apoio: https://aka.ms/CLI_refstatus

Inicie uma máquina virtual.

Esta operação pode demorar algum tempo.

az lab vm start --lab-name
                --name
                --resource-group

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

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

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
valor predefinido: json
--query

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

--subscription

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

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

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da máquina virtual.

--resource-group -g

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

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
valor predefinido: json
--query

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

--subscription

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

--verbose

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