Compartir a través de

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

Nombre Description Tipo Estado
az vm run-command create

Operación para crear el comando run.

 Principal GA
az vm run-command delete

Operación para eliminar el comando run.

 Principal GA
az vm run-command invoke

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

 Principal GA
az vm run-command list

Enumera los comandos de ejecución desde una máquina virtual o una ubicación.

 Principal GA
az vm run-command show

Obtenga un comando de ejecución específico.

 Principal GA
az vm run-command update

Operación para actualizar el comando run.

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

 Principal GA

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

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"

Cree un comando de ejecución con la carga del flujo de salida del script en el blob de Azure Storage (URI de SAS).

az vm run-command create --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --run-command-name "myRunCommand" --vm-name "myVM" --output-blob-uri "https://mystorageaccount.blob.core.windows.net/mycontainer/RuncommandOutput.txt?sp=racw&st=2022-10-17T19:02:15Z&se=2022-10-18T03:02:15Z&spr=https&sv=2021-06-08&sr=b&sig=3BxtEasfdasdfasdfdYki9yvYsqc60V0%3D"

Parámetros requeridos

--name --run-command-name

Nombre del comando run 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

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

Valor predeterminado: False
--output-blob-uri

Especifique el blob de Azure Storage (URI de SAS) donde se cargará el flujo de salida del script.

--parameters

Parámetros usados por el script.

Uso: --parameters arg1=XX arg2=XX.

--protected-parameters

Parámetros usados por el script.

Uso: --protected-parameters credentials=somefoo secret=somefoo secret=somebar.

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

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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]
                         [--subscription]
                         [--vm-name]
                         [--yes]

Ejemplos

Elimine un comando run.

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 run 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 "Resource Id".

--no-wait

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

Valor predeterminado: False
--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.

--vm-name

El nombre de la máquina virtual.

--yes -y

No solicita confirmación.

Valor predeterminado: False
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.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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 Ejecutar el identificador de comando a través az vmss run-command listde .

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

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

Valor de: az vm run-command list

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 "Resource Id".

--name -n

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

--no-wait

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

Valor predeterminado: False
--parameters

Parámetros separados por espacios en 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.

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

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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

Enumera los comandos de ejecución desde una máquina virtual o una ubicación.

Puede especificar "--resource-group" y "--vm-name" para obtener todos los comandos de ejecución de una máquina virtual. O bien, puede especificar "--location" para enumerar 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

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

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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

Obtenga un comando de ejecución específico.

Puede especificar "--resource-group", "--run-command-name" y "--vm-name" para obtener el comando run en una máquina virtual. O bien, puede especificar "--command-id" y "--location" para obtener el comando run de una suscripción en una ubicación.

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

Ejemplos

Obtenga los comandos de ejecución en una 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 del comando.

--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 "Resource Id".

--instance-view

Vista de instancia de un comando de ejecución.

Valor predeterminado: False
--location -l

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

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

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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]
                         [--subscription]
                         [--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"

Actualice un comando de ejecución con la carga del flujo de salida del script en el blob de Azure Storage (URI de SAS).

az vm run-command update --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --run-command-name "myRunCommand" --vm-name "myVM" --output-blob-uri "https://mystorageaccount.blob.core.windows.net/mycontainer/RuncommandOutput.txt?sp=racw&st=2022-10-17T19:02:15Z&se=2022-10-18T03:02:15Z&spr=https&sv=2021-06-08&sr=b&sig=3BxtEasfdasdfasdfdYki9yvYsqc60V0%3D"

Parámetros requeridos

--name --run-command-name

Nombre del comando run 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

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 "Resource Id".

--location -l

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

Valor predeterminado: False
--output-blob-uri

Especifique el blob de Azure Storage (URI de SAS) donde se cargará el flujo de salida del script.

--parameters

Parámetros usados por el script.

Uso: --parameters arg1=XX arg2=XX.

--protected-parameters

Parámetros usados por el script.

Uso: --protected-parameters credentials=somefoo secret=somefoo secret=somebar.

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

--subscription

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

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

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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]
                       [--ids]
                       [--instance-view]
                       [--interval]
                       [--location]
                       [--name]
                       [--resource-group]
                       [--subscription]
                       [--timeout]
                       [--updated]
                       [--vm-name]

Parámetros opcionales

--command-id

Identificador del comando.

--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
--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 "Resource Id".

--instance-view

Vista de instancia de un comando de ejecución.

Valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--location -l

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

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.