az vm run-command

  • Riferimento

Gestire i comandi di esecuzione in una macchina virtuale.

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

Operazione per creare il comando run.

 Memoria centrale Disponibilità generale
az vm run-command delete

Operazione per eliminare il comando di esecuzione.

 Memoria centrale Disponibilità generale
az vm run-command invoke

Eseguire un comando di esecuzione specifico in una macchina virtuale.

 Memoria centrale Disponibilità generale
az vm run-command list

Elencare i comandi di esecuzione da una macchina virtuale o da un percorso.

 Memoria centrale Disponibilità generale
az vm run-command show

Ottenere un comando di esecuzione specifico.

 Memoria centrale Disponibilità generale
az vm run-command update

Operazione per aggiornare il comando run.

 Memoria centrale Disponibilità generale
az vm run-command wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione del comando res virtual-machine-run-command.

 Memoria centrale Disponibilità generale

az vm run-command create

Modifica

Operazione per creare il 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]

Esempio

Creare un comando di esecuzione.

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"

Creare un comando di esecuzione con il caricamento del flusso di output dello script nel BLOB di archiviazione di Azure .Create a run command with uploading script output stream to Azure storage BLOB (SAS URI).

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"

Parametri necessari

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

--vm-name

Nome 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

Specificare il BLOB di archiviazione di Azure 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

Specificare l'URI di archiviazione di Azure in cui verrà caricato il flusso di 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 vm run-command delete

Modifica

Operazione per eliminare il comando di esecuzione.

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

Esempio

Eliminare un comando run.

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

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

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

--vm-name

Nome della macchina virtuale.

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

Modifica

Eseguire un comando di esecuzione specifico in una macchina virtuale.

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

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

Esempio

Installare nginx in una macchina virtuale Linux.

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

Eseguire il comando shell in una macchina virtuale Linux con parametri.

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

Eseguire lo script di PowerShell in una macchina virtuale Windows con parametri. Script fornito inline. Fare attenzione all'uso di virgolette singole in 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'

Eseguire lo script di PowerShell in una macchina virtuale 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 vm run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group \
    --scripts @script.ps1 --parameters "arg1=somefoo" "arg2=somebar"

Parametri necessari

--command-id

ID del comando.

Valore da: az vm 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".

--name -n

Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>.

--no-wait

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

Valore predefinito: False
--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 vm run-command list

Modifica

Elencare i comandi di esecuzione da una macchina virtuale o da un percorso.

È possibile specificare "--resource-group" e "--vm-name" per ottenere tutti i comandi di esecuzione di una macchina virtuale. In alternativa, è possibile specificare "--location" per elencare tutti i comandi di esecuzione disponibili per una sottoscrizione in un percorso.

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

Esempio

Elencare i comandi di esecuzione in una macchina virtuale.

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

Elencare tutti i comandi di esecuzione disponibili per una sottoscrizione in un percorso.

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

Parametri facoltativi

--expand

Espressione di espansione da applicare all'operazione.

--location -l

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

--resource-group -g

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

--vm-name

Nome della macchina virtuale.

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

Modifica

Ottenere un comando di esecuzione specifico.

È possibile specificare "--resource-group", "--run-command-name" e "--vm-name" per ottenere il comando di esecuzione in una macchina virtuale. In alternativa, è possibile specificare "--command-id" e "--location" per ottenere il comando run per una sottoscrizione in un percorso.

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

Esempio

Ottenere i comandi di esecuzione in una macchina virtuale.

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

Ottenere un comando di esecuzione specifico per una sottoscrizione in un percorso.

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

Parametri facoltativi

--command-id

ID del comando.

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

Visualizzazione dell'istanza di un comando di esecuzione.

Valore predefinito: False
--location -l

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

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

--subscription

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

--vm-name

Nome della macchina virtuale.

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

Modifica

Operazione per aggiornare il 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]

Esempio

Aggiornare un comando di esecuzione.

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"

Aggiornare un comando di esecuzione con il caricamento del flusso di output dello script nel BLOB di archiviazione di Azure .Update a run command with uploading script output stream to Azure storage BLOB (SAS URI).

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"

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

Specificare il BLOB di archiviazione di Azure 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".

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

Specificare l'URI di archiviazione di Azure in cui verrà caricato il flusso di 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.

--vm-name

Nome della macchina virtuale.

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 vm run-command wait

Modifica

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione 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]

Parametri facoltativi

--command-id

ID del comando.

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--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-view

Visualizzazione dell'istanza di un comando di esecuzione.

Valore predefinito: False
--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--location -l

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

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

--subscription

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

--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
--vm-name

Nome della macchina virtuale.

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.