az vm run-command
Gestire i comandi di esecuzione in una macchina virtuale.
Per altre informazioni, vedere https://learn.microsoft.com/azure/virtual-machines/windows/run-command o https://learn.microsoft.com/azure/virtual-machines/linux/run-command.
Comandi
Nome | Descrizione | Tipo | Status |
---|---|---|---|
az vm run-command create |
Operazione per creare il comando run. |
Nucleo | GA |
az vm run-command delete |
Operazione per eliminare il comando di esecuzione. |
Nucleo | GA |
az vm run-command invoke |
Eseguire un comando di esecuzione specifico in una macchina virtuale. |
Nucleo | GA |
az vm run-command list |
Elencare i comandi di esecuzione da una macchina virtuale o da un percorso. |
Nucleo | GA |
az vm run-command show |
Ottenere un comando di esecuzione specifico. |
Nucleo | GA |
az vm run-command update |
Operazione per aggiornare il comando run. |
Nucleo | GA |
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. |
Nucleo | GA |
az vm run-command create
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
Nome del comando run della macchina virtuale.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Nome della macchina virtuale.
Parametri facoltativi
Opzionale. Se impostato su true, il provisioning verrà completato non appena viene avviato lo script e non attenderà il completamento dello script.
Specificare un commandId dello script predefinito.
Specificare il BLOB di archiviazione di Azure in cui verrà caricato il flusso di errori dello script.
Ubicazione. Valori da: az account list-locations
. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>
.
Non attendere il completamento dell'operazione a esecuzione prolungata.
Specificare l'URI di archiviazione di Azure in cui verrà caricato il flusso di output dello script.
Parametri utilizzati dallo script.
Utilizzo: --parameters arg1=XX arg2=XX.
Parametri utilizzati dallo script.
Utilizzo: --protected-parameters credentials=somefoo secret=somebar.
Password se necessario per l'uso del parametro run-as-user. Verrà crittografato e non registrato.
Per impostazione predefinita, il processo di script viene eseguito con l'utente di sistema/radice. Specificare l'utente personalizzato per ospitare il processo.
Specificare il contenuto dello script da eseguire nella macchina virtuale.
Specificare il percorso di download dello script.
Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.
Timeout in secondi per eseguire il comando di esecuzione.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az vm run-command delete
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
Nome del comando run della macchina virtuale.
Parametri facoltativi
Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Non attendere il completamento dell'operazione a esecuzione prolungata.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Nome della macchina virtuale.
Non richiedere conferma.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az vm run-command invoke
Eseguire un comando di esecuzione specifico in una macchina virtuale.
az vm run-command show
restituisce informazioni utili su ogni comando run-command. Individuare Esegui 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
ID del comando.
Parametri facoltativi
Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Nome della macchina virtuale. È possibile configurare l'impostazione predefinita usando az configure --defaults vm=<name>
.
Non attendere il completamento dell'operazione a esecuzione prolungata.
Parametri separati da spazi nel formato '[name=]value'.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Righe di script separate da spazi. Usare @{file} per caricare lo script da un file.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az vm run-command list
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
Espressione di espansione da applicare all'operazione.
Ubicazione. Valori da: az account list-locations
. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>
.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Nome della macchina virtuale.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az vm run-command show
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]
[--expand]
[--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
ID del comando.
L'argomento 'expand' è stato deprecato e verrà rimosso in una versione futura.
Espressione di espansione da applicare all'operazione.
Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Visualizzazione dell'istanza di un comando di esecuzione.
Ubicazione. Valori da: az account list-locations
. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>
.
Nome del comando run della macchina virtuale.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Nome della macchina virtuale.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
az vm run-command update
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
Nome del comando run della macchina virtuale.
Parametri facoltativi
Opzionale. Se impostato su true, il provisioning verrà completato non appena viene avviato lo script e non attenderà il completamento dello script.
Specificare un commandId dello script predefinito.
Specificare il BLOB di archiviazione di Azure in cui verrà caricato il flusso di errori dello script.
Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Ubicazione. Valori da: az account list-locations
. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>
.
Non attendere il completamento dell'operazione a esecuzione prolungata.
Specificare l'URI di archiviazione di Azure in cui verrà caricato il flusso di output dello script.
Parametri utilizzati dallo script.
Utilizzo: --parameters arg1=XX arg2=XX.
Parametri utilizzati dallo script.
Utilizzo: --protected-parameters credentials=somefoo secret=somebar.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Password se necessario per l'uso del parametro run-as-user. Verrà crittografato e non registrato.
Per impostazione predefinita, il processo di script viene eseguito con l'utente di sistema/radice. Specificare l'utente personalizzato per ospitare il processo.
Specificare il contenuto dello script da eseguire nella macchina virtuale.
Specificare il percorso di download dello script.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.
Timeout in secondi per eseguire il comando di esecuzione.
Nome della macchina virtuale.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.
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.
az vm run-command wait [--command-id]
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--ids]
[--instance-view]
[--interval]
[--location]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
[--vm-name]
Parametri facoltativi
ID del comando.
Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.
Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Attendere l'eliminazione.
Attendere che la risorsa esista.
L'argomento 'expand' è stato deprecato e verrà rimosso in una versione futura.
Espressione di espansione da applicare all'operazione.
Uno o più ID risorsa (delimitati da spazi). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".
Visualizzazione dell'istanza di un comando di esecuzione.
Intervallo di polling in secondi.
Ubicazione. Valori da: az account list-locations
. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>
.
Nome del comando run della macchina virtuale.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito usando az configure --defaults group=<name>
.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Attesa massima in secondi.
Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.
Nome della macchina virtuale.
Parametri globali
Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.
Mostra questo messaggio della Guida e esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per i log di debug completi.