Partilhar via


az lab custom-image

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 imagens personalizadas de um laboratório devtest.

Comandos

Name Description Tipo Status
az lab custom-image create

Crie uma imagem personalizada existente. Esta operação pode demorar algum tempo a concluir.

Core Preview
az lab custom-image delete

Excluir imagem personalizada. Esta operação pode demorar algum tempo a concluir.

Core Preview
az lab custom-image list

Listar imagens personalizadas em um determinado laboratório.

Core Preview
az lab custom-image show

Obtenha uma imagem personalizada.

Core Preview
az lab custom-image wait

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

Core Preview

az lab custom-image create

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 imagem personalizada existente. Esta operação pode demorar algum tempo a concluir.

az lab custom-image create --lab-name
                           --name
                           --os-state
                           --os-type {Linux, Windows}
                           --resource-group
                           --source-vm-id
                           [--author]
                           [--description]
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Exemplos

Crie uma imagem personalizada no laboratório a partir de uma máquina virtual do Windows em execução sem aplicar sysprep.

az lab custom-image create --lab-name {LabName} -g {ResourceGroup} --name {VMName} --os-type Windows --os-state NonSysprepped --source-vm-id "/subscriptions/{SubID}/resourcegroups/{ResourceGroup}/providers/microsoft.devtestlab/labs/{LabName}/virtualmachines/{VMName}"

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name -n

O nome da imagem personalizada.

--os-state

O estado atual da máquina virtual. Para máquinas virtuais Windows: NonSysprepped, SysprepRequested, SysprepApplied. Para máquinas virtuais Linux: NonDeprovisioned, DeprovisionRequested, DeprovisionApplied.

--os-type

Tipo de SO no qual a imagem personalizada se baseia.

Propriedade Valor
Valores aceites: Linux, Windows
--resource-group -g

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

--source-vm-id

A ID do recurso de uma máquina virtual no laboratório fornecido.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--author

O autor da imagem personalizada.

--description

A descrição da imagem personalizada.

--no-wait

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az lab custom-image delete

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

Excluir imagem personalizada. Esta operação pode demorar algum tempo a concluir.

az lab custom-image 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 imagem personalizada.

--resource-group -g

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

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

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

Não solicite confirmação.

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

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az lab custom-image list

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

Listar imagens personalizadas em um determinado laboratório.

az lab custom-image list --lab-name
                         --resource-group
                         [--expand]
                         [--filter]
                         [--max-items]
                         [--next-token]
                         [--orderby]
                         [--top]

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand

Especifique o $expand consulta. Exemplo: 'properties($select=vm)'.

--filter

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.

Propriedade Valor
Parameter group: Pagination Arguments
--next-token

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

Propriedade Valor
Parameter group: Pagination Arguments
--orderby

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.

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az lab custom-image show

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 uma imagem personalizada.

az lab custom-image show --lab-name
                         --name
                         --resource-group
                         [--expand]

Parâmetros Obrigatórios

--lab-name

O nome do laboratório.

--name

O nome da imagem personalizada.

--resource-group -g

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand

Especifique o $expand consulta. Exemplo: 'properties($select=vm)'.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

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

Propriedade Valor
Default value: False

az lab custom-image wait

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

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

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

Propriedade Valor
Parameter group: Wait Condition Arguments
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'].

Propriedade Valor
Parameter group: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
--expand

Especifique o $expand consulta. Exemplo: 'properties($select=vm)'.

--ids

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

Propriedade Valor
Parameter group: Resource Id Arguments
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: 30
--lab-name

O nome do laboratório.

Propriedade Valor
Parameter group: Resource Id Arguments
--name

O nome da imagem personalizada.

Propriedade Valor
Parameter group: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Parameter group: Resource Id Arguments
--subscription

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

Propriedade Valor
Parameter group: Resource Id Arguments
--timeout

Espera máxima em segundos.

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: 3600
--updated

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

Propriedade Valor
Parameter group: Wait Condition Arguments
Default value: False
Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

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

Propriedade Valor
Default value: False