az vm run-command

Referencia

Administrar comandos de ejecución en una máquina virtual.

Para obtener más información, vea https://docs.microsoft.com/azure/virtual-machines/windows/run-command o https://docs.microsoft.com/azure/virtual-machines/linux/run-command.

Comandos

az vm run-command create	Operación para crear el comando run.
az vm run-command delete	Operación para eliminar el comando run.
az vm run-command invoke	Ejecute un comando de ejecución específico en una máquina virtual.
az vm run-command list	Operación para obtener todos los comandos de ejecución de una máquina virtual. Y enumera todos los comandos de ejecución disponibles para una suscripción en una ubicación.
az vm run-command show	Operación para obtener el comando run. Y obtiene un comando de ejecución específico para una suscripción en una ubicación.
az vm run-command update	Operación para actualizar el comando run.
az vm run-command wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición del comando res virtual-machine-run-command.

az vm run-command create

Editar

Operación para crear el comando run.

az vm run-command create --name
                         --resource-group
                         --vm-name
                         [--async-execution {false, true}]
                         [--command-id]
                         [--error-blob-uri]
                         [--location]
                         [--no-wait]
                         [--output-blob-uri]
                         [--parameters]
                         [--protected-parameters]
                         [--run-as-password]
                         [--run-as-user]
                         [--script]
                         [--script-uri]
                         [--tags]
                         [--timeout-in-seconds]

Ejemplos

Cree un comando de ejecución.

az vm run-command create --resource-group "myResourceGroup" --location "West US" --async-execution false --parameters arg1=param1 arg2=value1 --run-as-password "<runAsPassword>" --run-as-user "user1" --script "Write-Host Hello World!" --timeout-in-seconds 3600 --run-command-name "myRunCommand" --vm-name "myVM"

Parámetros requeridos

--name --run-command-name

Nombre del comando de ejecución de la máquina virtual.

--resource-group -g

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

--vm-name

El nombre de la máquina virtual.

Parámetros opcionales

--async-execution

Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script.

valores aceptados: false, true

--command-id

Especifique un commandId de script integrado predefinido.

--error-blob-uri

Especifique el blob de Azure Storage donde se cargará el flujo de error del script.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--no-wait

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

--output-blob-uri

Especifique el blob de Azure Storage donde se cargará el flujo de salida del script.

--parameters

Parámetros usados por el script.

--protected-parameters

Parámetros usados por el script.

--run-as-password

Contraseña si es necesario para usar el parámetro run-as-user. Se cifrará y no se registrará.

--run-as-user

De forma predeterminada, el proceso de script se ejecuta en el usuario raíz o del sistema. Especifique el usuario personalizado para hospedar el proceso.

--script

Especifique el contenido del script que se va a ejecutar en la máquina virtual.

--script-uri

Especifique la ubicación de descarga del script.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--timeout-in-seconds

Tiempo de espera en segundos para ejecutar el comando run.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az vm run-command delete

Editar

Operación para eliminar el comando run.

az vm run-command delete --name
                         [--ids]
                         [--no-wait]
                         [--resource-group]
                         [--vm-name]
                         [--yes]

Ejemplos

Elimine un comando de ejecución.

az vm run-command delete --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vm-name "myVM"

Parámetros requeridos

--name --run-command-name

Nombre del comando de ejecución de la máquina virtual.

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). 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 de "Id. de recurso".

--no-wait

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

--resource-group -g

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

--vm-name

El nombre de la máquina virtual.

--yes -y

No solicita confirmación.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az vm run-command invoke

Editar

Ejecute un comando de ejecución específico en una máquina virtual.

az vm run-command show devuelve información útil sobre cada comando de ejecución. Descubra Run command-id's a través az vmss run-command listde .

az vm run-command invoke --command-id
                         [--ids]
                         [--name]
                         [--parameters]
                         [--resource-group]
                         [--scripts]

Ejemplos

Instale nginx en una máquina virtual Linux.

az vm run-command invoke -g MyResourceGroup -n MyVm --command-id RunShellScript --scripts "sudo apt-get update && sudo apt-get install -y nginx"

Ejecute el comando shell en una máquina virtual Linux con parámetros.

az vm run-command invoke -g MyResourceGroup -n MyVm --command-id RunShellScript --scripts 'echo $1 $2' --parameters hello world

Ejecute el script de PowerShell en una máquina virtual windows con parámetros. Script proporcionado en línea. Tenga cuidado con las comillas simples en CMD.exe.

az vm run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group  \
    --scripts 'param([string]$arg1,[string]$arg2)' \
    'Write-Host This is a sample script with parameters $arg1 and $arg2' \
    --parameters 'arg1=somefoo' 'arg2=somebar'

Ejecute el script de PowerShell en una máquina virtual windows con parámetros. Script proporcionado desde el archivo.

# script.ps1
#   param(
#       [string]$arg1,
#       [string]$arg2
#   )
#   Write-Host This is a sample script with parameters $arg1 and $arg2

az vm run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group \
    --scripts @script.ps1 --parameters "arg1=somefoo" "arg2=somebar"

Parámetros requeridos

--command-id

Identificador de comando.

valor de: az vm run-command list

Parámetros opcionales

--ids

--name -n

Nombre de la máquina virtual. Puede configurar el valor predeterminado mediante az configure --defaults vm=<name>.

--parameters

Parámetros separados por espacios con el formato '[name=]value'.

--resource-group -g

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

--scripts

Líneas de script separadas por espacios. Use @{file} para cargar el script desde un archivo.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az vm run-command list

Editar

Operación para obtener todos los comandos de ejecución de una máquina virtual. Y enumera todos los comandos de ejecución disponibles para una suscripción en una ubicación.

az vm run-command list [--expand]
                       [--location]
                       [--resource-group]
                       [--vm-name]

Ejemplos

Enumerar comandos de ejecución en una máquina virtual.

az vm run-command list --resource-group "myResourceGroup" --vm-name "myVM"

Enumere todos los comandos de ejecución disponibles para una suscripción en una ubicación.

az vm run-command list --location "SoutheastAsia"

Parámetros opcionales

--expand

Expresión expand que se va a aplicar en la operación.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--resource-group -g

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

--vm-name

El nombre de la máquina virtual.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az vm run-command show

Editar

Operación para obtener el comando run. Y obtiene un comando de ejecución específico para una suscripción en una ubicación.

az vm run-command show [--command-id]
                       [--expand]
                       [--ids]
                       [--instance-view]
                       [--location]
                       [--name]
                       [--resource-group]
                       [--vm-name]

Ejemplos

Obtenga los comandos de ejecución en la máquina virtual.

az vm run-command show --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vm-name "myVM"

Obtenga un comando de ejecución específico para una suscripción en una ubicación.

az vm run-command show --command-id "RunPowerShellScript" --location "SoutheastAsia"

Parámetros opcionales

--command-id

Identificador de comando.

--expand

Expresión expand que se va a aplicar en la operación.

--ids

--instance-view

Vista de instancia de un comando de ejecución.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name --run-command-name

Nombre del comando de ejecución de la máquina virtual.

--resource-group -g

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

--vm-name

El nombre de la máquina virtual.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az vm run-command update

Editar

Operación para actualizar el comando run.

az vm run-command update --name
                         [--async-execution {false, true}]
                         [--command-id]
                         [--error-blob-uri]
                         [--ids]
                         [--location]
                         [--no-wait]
                         [--output-blob-uri]
                         [--parameters]
                         [--protected-parameters]
                         [--resource-group]
                         [--run-as-password]
                         [--run-as-user]
                         [--script]
                         [--script-uri]
                         [--tags]
                         [--timeout-in-seconds]
                         [--vm-name]

Ejemplos

Actualice un comando de ejecución.

az vm run-command update --resource-group "myResourceGroup" --location "West US" --async-execution false --parameters arg1=param1 arg2=value1 --run-as-password "<runAsPassword>" --run-as-user "user1" --script "Write-Host Hello World!" --timeout-in-seconds 3600 --run-command-name "myRunCommand" --vm-name "myVM"

Parámetros requeridos

--name --run-command-name

Nombre del comando de ejecución de la máquina virtual.

Parámetros opcionales

--async-execution

Opcional. Si se establece en true, el aprovisionamiento se completará en cuanto se inicie el script y no esperará a que se complete el script.

valores aceptados: false, true

--command-id

Especifique un commandId de script integrado predefinido.

--error-blob-uri

Especifique el blob de Azure Storage donde se cargará el flujo de error del script.

--ids

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--no-wait

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

--output-blob-uri

Especifique el blob de Azure Storage donde se cargará el flujo de salida del script.

--parameters

Parámetros usados por el script.

--protected-parameters

Parámetros usados por el script.

--resource-group -g

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

--run-as-password

Contraseña si es necesario para usar el parámetro run-as-user. Se cifrará y no se registrará.

--run-as-user

De forma predeterminada, el proceso de script se ejecuta en el usuario raíz o del sistema. Especifique el usuario personalizado para hospedar el proceso.

--script

Especifique el contenido del script que se va a ejecutar en la máquina virtual.

--script-uri

Especifique la ubicación de descarga del script.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--timeout-in-seconds

Tiempo de espera en segundos para ejecutar el comando run.

--vm-name

El nombre de la máquina virtual.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az vm run-command wait

Editar

Coloque la CLI en un estado de espera hasta que se cumpla una condición del comando res virtual-machine-run-command.

az vm run-command wait [--command-id]
                       [--created]
                       [--custom]
                       [--deleted]
                       [--exists]
                       [--expand]
                       [--ids]
                       [--instance-view]
                       [--interval]
                       [--location]
                       [--name]
                       [--resource-group]
                       [--timeout]
                       [--updated]
                       [--vm-name]

Parámetros opcionales

--command-id

Identificador de comando.

--created

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

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

--exists

Espere hasta que exista el recurso.

--expand

Expresión expand que se va a aplicar en la operación.

--ids

--instance-view

Vista de instancia de un comando de ejecución.

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--name --run-command-name

Nombre del comando de ejecución de la máquina virtual.

--resource-group -g

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

--timeout

Espera máxima en segundos.

valor predeterminado: 3600

--updated

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

--vm-name

El nombre de la máquina virtual.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az vm run-command

Comandos

az vm run-command create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az vm run-command delete

Ejemplos

Parámetros requeridos

Parámetros opcionales

az vm run-command invoke

Ejemplos

Parámetros requeridos

Parámetros opcionales

az vm run-command list

Ejemplos

Parámetros opcionales

az vm run-command show

Ejemplos

Parámetros opcionales

az vm run-command update

Ejemplos

Parámetros requeridos

Parámetros opcionales

az vm run-command wait

Parámetros opcionales

Comentarios