Compartir a través de

az vmss run-command

  • Referencia

Administrar comandos de ejecución en un conjunto de escalado de máquinas virtuales.

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 vmss run-command create

Operación para crear el comando VMSS VM run.

 Principal GA
az vmss run-command delete

Operación para eliminar el comando run.

 Principal GA
az vmss run-command invoke

Ejecute un comando de ejecución específico en una instancia del conjunto de escalado de máquinas virtuales.

 Principal GA
az vmss run-command list

La operación para obtener todos los comandos de ejecución de una instancia en el conjunto de escalado de máquinas virtuales.

 Principal GA
az vmss run-command show

Operación para obtener el comando de ejecución de VMSS.

 Principal GA
az vmss run-command update

Operación para actualizar el comando de ejecución de VMSS.

 Principal GA

az vmss run-command create

Editar

Operación para crear el comando VMSS VM run.

az vmss run-command create --instance-id
                           --name
                           --resource-group
                           --vmss-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 de VMSS.

az vmss run-command create --resource-group "myResourceGroup" --instance-id "0" --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" --vmss-name "myVMSS"

Parámetros requeridos

--instance-id

Identificador de instancia de la máquina virtual.

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

--vmss-name

Nombre del conjunto de escalado de máquinas virtuales.

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

Uri (sin SAS) en un blob anexado 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

Uri (sin SAS) en un blob en anexos donde se cargará la 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 vmss run-command delete

Editar

Operación para eliminar el comando run.

az vmss run-command delete --name
                           [--ids]
                           [--instance-id]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]
                           [--vmss-name]
                           [--yes]

Ejemplos

Operación para eliminar el comando de ejecución de VMSS.

az vmss run-command delete --resource-group "myResourceGroup" --instance-id "0" --run-command-name "myRunCommand" --vmss-name "myVMSS"

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

--instance-id

Identificador de instancia de la máquina virtual.

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

--vmss-name

Nombre del conjunto de escalado de máquinas virtuales.

--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 vmss run-command invoke

Editar

Ejecute un comando de ejecución específico en una instancia del conjunto de escalado de máquinas virtuales.

az vmss 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 vmss run-command invoke --command-id
                           [--ids]
                           [--instance-id]
                           [--name]
                           [--parameters]
                           [--resource-group]
                           [--scripts]
                           [--subscription]

Ejemplos

Instale nginx en una instancia de VMSS.

az vmss run-command invoke -g MyResourceGroup -n MyVMSS --command-id RunShellScript \ --instance-id 0 --scripts "sudo apt-get update && sudo apt-get install -y nginx"

Invoque un comando de ejecución con parámetros en una instancia de VMSS.

az vmss run-command invoke -g MyResourceGroup -n MyVMSS --command-id RunShellScript \ --instance-id 4 --scripts 'echo $1 $2' --parameters hello world

Invoque el comando en todas las instancias de VMSS mediante los identificadores de recursos de instancia de VMSS. Nota: "@-" se expande a stdin.

az vmss list-instances -n MyVMSS -g my-rg --query "[].id" --output tsv | \
az vmss run-command invoke --scripts 'echo $1 $2' --parameters hello world  \
    --command-id RunShellScript --ids @-

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

az vmss 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' --instance-id 2

Ejecute el script de PowerShell en una instancia de VMSS 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 vmss run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group \
    --scripts @script.ps1 --parameters "arg1=somefoo" "arg2=somebar" --instance-id 5

Parámetros requeridos

--command-id

Identificador del comando.

Valor de: az vmss 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".

--instance-id

Id. de instancia de máquina virtual del conjunto de escalado.

--name -n

Nombre del conjunto de escalado. Puede configurar el valor predeterminado mediante az configure --defaults vmss=<name>.

--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 vmss run-command list

Editar

La operación para obtener todos los comandos de ejecución de una instancia en el conjunto de escalado de máquinas virtuales.

az vmss run-command list --instance-id
                         --resource-group
                         --vmss-name
                         [--expand]

Ejemplos

Enumera los comandos de ejecución en la instancia de Vmss.

az vmss run-command list --resource-group "myResourceGroup" --vmss-name "myVMSS" --instance-id "0"

Parámetros requeridos

--instance-id

Identificador de instancia de la máquina virtual.

--resource-group -g

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

--vmss-name

Nombre del conjunto de escalado de máquinas virtuales.

Parámetros opcionales

--expand

Expresión expand que se va a aplicar en la operació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.

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 vmss run-command show

Editar

Operación para obtener el comando de ejecución de VMSS.

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

Ejemplos

Obtiene comandos de ejecución de VMSS.

az vmss run-command show --instance-id "0" --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vmss-name "myVMSS"

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

--instance-id

Identificador de instancia de la máquina virtual.

--instance-view

Vista de instancia de un comando de ejecución.

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.

--vmss-name

Nombre del conjunto de escalado de máquinas virtuales.

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 vmss run-command update

Editar

Operación para actualizar el comando de ejecución de VMSS.

az vmss run-command update --name
                           [--async-execution {false, true}]
                           [--command-id]
                           [--error-blob-uri]
                           [--ids]
                           [--instance-id]
                           [--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]
                           [--vmss-name]

Ejemplos

Actualice el comando de ejecución de VMSS.

az vmss run-command update --resource-group "myResourceGroup" --instance-id "0" --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" --vmss-name "myVMSS"

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

Uri (sin SAS) en un blob anexado 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".

--instance-id

Identificador de instancia de la máquina virtual.

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

Uri (sin SAS) en un blob en anexos donde se cargará la 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.

--vmss-name

Nombre del conjunto de escalado de máquinas virtuales.

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.