Condividi tramite

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.

 Core GA
az vm run-command delete

Operazione per eliminare il comando di esecuzione.

 Core GA
az vm run-command invoke

Eseguire un comando di esecuzione specifico in una macchina virtuale.

 Core GA
az vm run-command list

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

 Core GA
az vm run-command show

Ottenere un comando di esecuzione specifico.

 Core GA
az vm run-command update

Operazione per aggiornare il comando run.

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

 Core GA

az vm run-command create

Modifica

Operazione per creare il comando run.

az vm run-command create --name --run-command-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 usando az configure --defaults group=<name>.

--vm-name

Nome della macchina virtuale.

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--async-execution

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

Proprietà Valore
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

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
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

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az vm run-command delete

Modifica

Operazione per eliminare il comando di esecuzione.

az vm run-command delete --name --run-command-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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
Valore predefinito: False
--resource-group -g

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

Proprietà Valore
Parameter group: Resource Id Arguments
--subscription

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

Proprietà Valore
Parameter group: Resource Id Arguments
--vm-name

Nome della macchina virtuale.

Proprietà Valore
Parameter group: Resource Id Arguments
--yes -y

Non richiedere conferma.

Proprietà Valore
Valore predefinito: False
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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

--command-id

ID del comando.

Proprietà Valore
Valore da: az vm run-command list

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--name -n

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

Proprietà Valore
Parameter group: Resource Id Arguments
--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
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 usando az configure --defaults group=<name>.

Proprietà Valore
Parameter group: Resource Id Arguments
--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 posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand

Espressione di espansione da applicare all'operazione.

--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--resource-group -g

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

--vm-name

Nome della macchina virtuale.

Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--subscription

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--command-id

ID del comando.

--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--instance-view

Visualizzazione dell'istanza di un comando di esecuzione.

Proprietà Valore
Valore predefinito: False
--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando 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 usando az configure --defaults group=<name>.

Proprietà Valore
Parameter group: Resource Id Arguments
--subscription

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

Proprietà Valore
Parameter group: Resource Id Arguments
--vm-name

Nome della macchina virtuale.

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--verbose

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

Proprietà Valore
Valore predefinito: False

az vm run-command update

Modifica

Operazione per aggiornare il comando run.

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--async-execution

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

Proprietà Valore
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 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".

Proprietà Valore
Parameter group: Resource Id Arguments
--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--no-wait

Non attendere il completamento dell'operazione a esecuzione prolungata.

Proprietà Valore
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 usando az configure --defaults group=<name>.

Proprietà Valore
Parameter group: Resource Id Arguments
--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 posizione predefinito usando az account set -s NAME_OR_ID.

Proprietà Valore
Parameter group: Resource Id Arguments
--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.

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--verbose

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

Proprietà Valore
Valore predefinito: False

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 --run-command-name]
                       [--resource-group]
                       [--subscription]
                       [--timeout]
                       [--updated]
                       [--vm-name]

Parametri facoltativi

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--command-id

ID del comando.

--created

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

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: False
--custom

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

Proprietà Valore
Parameter group: Wait Condition Arguments
--deleted

Attendere l'eliminazione.

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: False
--exists

Attendere che la risorsa esista.

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: False
--ids

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

Proprietà Valore
Parameter group: Resource Id Arguments
--instance-view

Visualizzazione dell'istanza di un comando di esecuzione.

Proprietà Valore
Valore predefinito: False
--interval

Intervallo di polling in secondi.

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: 30
--location -l

Location. Usare i valori ottenuti con az account list-locations. È possibile configurare il percorso predefinito usando 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 usando az configure --defaults group=<name>.

Proprietà Valore
Parameter group: Resource Id Arguments
--subscription

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

Proprietà Valore
Parameter group: Resource Id Arguments
--timeout

Attesa massima in secondi.

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: 3600
--updated

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

Proprietà Valore
Parameter group: Wait Condition Arguments
Valore predefinito: False
--vm-name

Nome della macchina virtuale.

Proprietà Valore
Parameter group: Resource Id Arguments
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

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

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

--verbose

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

Proprietà Valore
Valore predefinito: False