az vmss run-command

  • Riferimento

Gestire i comandi di esecuzione in un set di scalabilità di macchine virtuali.

Per altre informazioni, vedere https://docs.microsoft.com/azure/virtual-machines/windows/run-command o https://docs.microsoft.com/azure/virtual-machines/linux/run-command.

Comandi

Nome Descrizione Tipo Status
az vmss run-command create

Operazione per creare il comando di esecuzione della macchina virtuale VMSS.

 Memoria centrale Disponibilità generale
az vmss run-command delete

Operazione per eliminare il comando di esecuzione.

 Memoria centrale Disponibilità generale
az vmss run-command invoke

Eseguire un comando di esecuzione specifico in un'istanza del set di scalabilità di macchine virtuali.

 Memoria centrale Disponibilità generale
az vmss run-command list

Operazione per ottenere tutti i comandi di esecuzione di un'istanza nel set di scalabilità di macchine virtuali.

 Memoria centrale Disponibilità generale
az vmss run-command show

Operazione per ottenere il comando di esecuzione del set di scalabilità di macchine virtuali.

 Memoria centrale Disponibilità generale
az vmss run-command update

Operazione per aggiornare il comando di esecuzione del set di scalabilità di macchine virtuali.

 Memoria centrale Disponibilità generale

az vmss run-command create

Modifica

Operazione per creare il comando di esecuzione della macchina virtuale VMSS.

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]

Esempio

Creare un comando di esecuzione del set di scalabilità di macchine virtuali.

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"

Parametri necessari

--instance-id

ID istanza della macchina virtuale.

--name --run-command-name

Nome del comando run della macchina virtuale.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--vmss-name

Nome del set di scalabilità di macchine virtuali.

Parametri facoltativi

--async-execution

(Facoltativo). Se impostato su true, il provisioning verrà completato non appena viene avviato lo script e non attenderà il completamento dello script.

Valori accettati: false, true
--command-id

Specificare un commandId dello script predefinito.

--error-blob-uri

Uri (senza firma di accesso condiviso) in un BLOB di accodamento in cui verrà caricato il flusso di errori dello script.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--output-blob-uri

URI (senza firma di accesso condiviso) in un BLOB di accodamento in cui verrà caricato l'output dello script.

--parameters

Parametri utilizzati dallo script.

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

--protected-parameters

Parametri utilizzati dallo script.

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

--run-as-password

Password se necessario per l'uso del parametro run-as-user. Verrà crittografato e non registrato.

--run-as-user

Per impostazione predefinita, il processo di script viene eseguito con l'utente di sistema/radice. Specificare l'utente personalizzato per ospitare il processo.

--script

Specificare il contenuto dello script da eseguire nella macchina virtuale.

--script-uri

Specificare il percorso di download dello script.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--timeout-in-seconds

Timeout in secondi per eseguire il comando di esecuzione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vmss run-command delete

Modifica

Operazione per eliminare il comando di esecuzione.

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

Esempio

L'operazione per eliminare il set di scalabilità di macchine virtuali esegue il comando.

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

Parametri necessari

--name --run-command-name

Nome del comando run della macchina virtuale.

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--instance-id

ID istanza della macchina virtuale.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--vmss-name

Nome del set di scalabilità di macchine virtuali.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vmss run-command invoke

Modifica

Eseguire un comando di esecuzione specifico in un'istanza del set di scalabilità di macchine virtuali.

az vmss run-command show restituisce informazioni utili su ogni comando di esecuzione. Individuare Esegui l'ID comando tramite az vmss run-command list.

az vmss run-command invoke --command-id
                           [--ids]
                           [--instance-id]
                           [--name]
                           [--parameters]
                           [--resource-group]
                           [--scripts]
                           [--subscription]

Esempio

Installare nginx in un'istanza del set di scalabilità di macchine virtuali.

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"

Richiamare un comando run-command con parametri in un'istanza del set di scalabilità di macchine virtuali.

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

Richiamare il comando in tutte le istanze del set di scalabilità di macchine virtuali usando gli ID risorsa dell'istanza del set di scalabilità di macchine virtuali. Nota: "@-" si espande fino 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 @-

Eseguire lo script di PowerShell in un'istanza del set di scalabilità di macchine virtuali Windows con parametri. Script fornito inline. Fare attenzione all'uso di virgolette singole in 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

Eseguire lo script di PowerShell in un'istanza del set di scalabilità di macchine virtuali Windows con parametri. Script fornito dal file.

# 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

Parametri necessari

--command-id

ID del comando.

Valore da: az vmss run-command list

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--instance-id

ID istanza della macchina virtuale del set di scalabilità.

--name -n

Nome del set di scalabilità. È possibile configurare l'impostazione predefinita usando az configure --defaults vmss=<name>.

--parameters

Parametri separati da spazi nel formato '[name=]value'.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--scripts

Righe di script separate da spazi. Usare @{file} per caricare lo script da un file.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vmss run-command list

Modifica

Operazione per ottenere tutti i comandi di esecuzione di un'istanza nel set di scalabilità di macchine virtuali.

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

Esempio

Elencare i comandi di esecuzione nell'istanza di Vmss.

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

Parametri necessari

--instance-id

ID istanza della macchina virtuale.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--vmss-name

Nome del set di scalabilità di macchine virtuali.

Parametri facoltativi

--expand

Espressione di espansione da applicare all'operazione.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vmss run-command show

Modifica

Operazione per ottenere il comando di esecuzione del set di scalabilità di macchine virtuali.

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

Esempio

Ottenere i comandi di esecuzione del set di scalabilità di macchine virtuali.

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

Parametri necessari

--name --run-command-name

Nome del comando run della macchina virtuale.

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--instance-id

ID istanza della macchina virtuale.

--instance-view

Visualizzazione dell'istanza di un comando di esecuzione.

Valore predefinito: False
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--vmss-name

Nome del set di scalabilità di macchine virtuali.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az vmss run-command update

Modifica

Operazione per aggiornare il comando di esecuzione del set di scalabilità di macchine virtuali.

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]

Esempio

Aggiornare il comando di esecuzione del set di scalabilità di macchine virtuali.

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"

Parametri necessari

--name --run-command-name

Nome del comando run della macchina virtuale.

Parametri facoltativi

--async-execution

(Facoltativo). Se impostato su true, il provisioning verrà completato non appena viene avviato lo script e non attenderà il completamento dello script.

Valori accettati: false, true
--command-id

Specificare un commandId dello script predefinito.

--error-blob-uri

Uri (senza firma di accesso condiviso) in un BLOB di accodamento in cui verrà caricato il flusso di errori dello script.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--instance-id

ID istanza della macchina virtuale.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--output-blob-uri

URI (senza firma di accesso condiviso) in un BLOB di accodamento in cui verrà caricato l'output dello script.

--parameters

Parametri utilizzati dallo script.

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

--protected-parameters

Parametri utilizzati dallo script.

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

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--run-as-password

Password se necessario per l'uso del parametro run-as-user. Verrà crittografato e non registrato.

--run-as-user

Per impostazione predefinita, il processo di script viene eseguito con l'utente di sistema/radice. Specificare l'utente personalizzato per ospitare il processo.

--script

Specificare il contenuto dello script da eseguire nella macchina virtuale.

--script-uri

Specificare il percorso di download dello script.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--timeout-in-seconds

Timeout in secondi per eseguire il comando di esecuzione.

--vmss-name

Nome del set di scalabilità di macchine virtuali.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.