Compartir a través de

az lab vm

  • Vista previa
  • Referencia

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Administración de máquinas virtuales en un laboratorio de azure devtest.

Comandos

Nombre Description Tipo Estado
az lab vm apply-artifacts

Aplique artefactos a la máquina virtual. Esta operación puede tardar un tiempo en completarse.

 Núcleo Vista previa
az lab vm claim

Comando para reclamar una máquina virtual en Azure DevTest Lab.

 Núcleo Vista previa
az lab vm create

Cree una máquina virtual en un laboratorio.

 Núcleo Vista previa
az lab vm delete

Elimine la máquina virtual. Esta operación puede tardar un tiempo en completarse.

 Núcleo Vista previa
az lab vm hibernate

Hibernar una máquina virtual Esta operación puede tardar un tiempo en completarse.

 Núcleo Vista previa
az lab vm list

Enumere las máquinas virtuales de un laboratorio determinado.

 Núcleo Vista previa
az lab vm show

Mostrar máquina virtual.

 Núcleo Vista previa
az lab vm start

Inicie una máquina virtual. Esta operación puede tardar un tiempo en completarse.

 Núcleo Vista previa
az lab vm stop

Detener una máquina virtual Esta operación puede tardar un tiempo en completarse.

 Núcleo Vista previa
az lab vm wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Núcleo Vista previa

az lab vm apply-artifacts

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Aplique artefactos a la máquina virtual. Esta operación puede tardar un tiempo en completarse.

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

Ejemplos

Aplique artefactos a una máquina virtual en Azure DevTest Lab.

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

Parámetros requeridos

--lab-name

Nombre del laboratorio.

--name -n

Nombre de la máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--artifacts

Ruta de acceso a la matriz codificada json de artefactos que se van a aplicar. Lista codificada de JSON de parámetros.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm claim

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Comando para reclamar una máquina virtual en Azure DevTest Lab.

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

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--lab-name

Nombre del laboratorio.

--name -n

Nombre de la máquina virtual que se va a reclamar.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm create

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree una máquina virtual en un laboratorio.

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 requeridos

--lab-name

Nombre del laboratorio.

--name -n

Nombre de la máquina virtual o el entorno.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--admin-password

Contraseña para el administrador de la máquina virtual.

--admin-username

Nombre de usuario del administrador de la máquina virtual.

Valor predeterminado: your_system_user_login_name
--allow-claim

Marca que indica si la máquina virtual se debe crear como reclamable.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Valor predeterminado: False
--artifacts

Ruta de acceso a la matriz codificada json de artefactos que se van a aplicar. Lista codificada de JSON de parámetros.

--authentication-type

Tipo de autenticación permitido para la máquina virtual.

Valores aceptados: password, ssh
Valor predeterminado: password
--disk-type

Tipo de almacenamiento que se va a usar para la máquina virtual.

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

Fecha de expiración de la máquina virtual.

--formula

Nombre de la fórmula. Use az lab formula list para las fórmulas disponibles. Use az lab formula con la marca --export-artifacts para exportar y actualizar artefactos y, a continuación, pase los resultados a través del argumento --artifacts.

--generate-ssh-keys

Genere archivos de clave pública y privada SSH si falta.

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

Nombre de la imagen del sistema operativo (nombre de imagen de la galería o nombre o identificador de imagen personalizado). Use az lab gallery-image list para imágenes de galería disponibles o az lab custom-image list para imágenes personalizadas disponibles.

--image-type

Tipo de la imagen.

Valores aceptados: custom, gallery
--ip-configuration

Tipo de configuración de IP que se va a usar para la máquina virtual.

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

No espere a que finalice la operación de ejecución prolongada.

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

Notas de la máquina virtual.

--saved-secret

Nombre del secreto guardado que se va a usar para la autenticación. Cuando se proporciona este valor, se usa en lugar de otros métodos de autenticación.

--size

Tamaño de la máquina virtual que se va a crear. Consulta https://azure.microsoft.com/pricing/details/virtual-machines/ para obtener información de tamaño.

--ssh-key

La clave pública SSH o la ruta de acceso del archivo de clave pública. Use --generate-ssh-keys para generar claves SSH.

--subnet

Nombre de la subred a la que se va a agregar la máquina virtual.

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--vnet-name

Nombre de la red virtual a la que se va a agregar la máquina virtual.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm delete

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine la máquina virtual. Esta operación puede tardar un tiempo en completarse.

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

Parámetros requeridos

--lab-name

Nombre del laboratorio.

--name

Nombre de la máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere a que finalice la operación de ejecución prolongada.

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

No solicite confirmación.

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm hibernate

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Hibernar una máquina virtual Esta operación puede tardar un tiempo en completarse.

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

Ejemplos

Hibernar una máquina virtual.

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

Parámetros requeridos

--lab-name

Nombre del laboratorio.

--name

Nombre de la máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm list

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere las máquinas virtuales de un laboratorio determinado.

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]

Ejemplos

Enumere las máquinas virtuales de azure DevTest Lab.

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

Parámetros requeridos

--lab-name

Nombre del laboratorio.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--all

Enumere todas las máquinas virtuales del laboratorio. No se puede usar con --filters.

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

Enumere solo las máquinas virtuales reclamables en el laboratorio. No se puede usar con --filters.

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

Nombre o identificador del entorno en el que se van a enumerar las máquinas virtuales. No se puede usar con --filters.

--expand

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

--filters

Filtro que se va a aplicar a la operación. Ejemplo: '$filter=contains(name,'myName').

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

--object-id

Id. de objeto del propietario para el que se van a enumerar las máquinas virtuales.

--order-by

Expresión de ordenación de los resultados, mediante notación OData. Ejemplo: "$orderby=name desc".

--top

Número máximo de recursos que se van a devolver de la operación. Ejemplo: '$top=10'.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm show

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Mostrar máquina virtual.

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

Parámetros requeridos

--lab-name

Nombre del laboratorio.

--name

Nombre de la máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--expand

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

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm start

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Inicie una máquina virtual. Esta operación puede tardar un tiempo en completarse.

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

Parámetros requeridos

--lab-name

Nombre del laboratorio.

--name

Nombre de la máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm stop

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Detener una máquina virtual Esta operación puede tardar un tiempo en completarse.

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

Parámetros requeridos

--lab-name

Nombre del laboratorio.

--name

Nombre de la máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.

az lab vm wait

Editar
Vista previa

El grupo de comandos "lab" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

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

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--expand

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

--ids

Uno o varios identificadores de recursos (delimitados por espacio). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--lab-name

Nombre del laboratorio.

--name

Nombre de la máquina virtual.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, supresión de advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Use --debug para registros de depuración completos.