az vm run-command
Verwalten von Ausführungsbefehlen auf einem virtuellen Computer.
Weitere Informationen finden Sie unter https://docs.microsoft.com/azure/virtual-machines/windows/run-command oder https://docs.microsoft.com/azure/virtual-machines/linux/run-command.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az vm run-command create |
Der Vorgang zum Erstellen des Ausführungsbefehls. |
Kernspeicher | Allgemein verfügbar |
az vm run-command delete |
Der Vorgang zum Löschen des Ausführungsbefehls. |
Kernspeicher | Allgemein verfügbar |
az vm run-command invoke |
Führen Sie einen bestimmten Ausführungsbefehl auf einem virtuellen Computer aus. |
Kernspeicher | Allgemein verfügbar |
az vm run-command list |
Führen Sie Befehle von einem virtuellen Computer oder einem Speicherort aus aus. |
Kernspeicher | Allgemein verfügbar |
az vm run-command show |
Abrufen eines bestimmten Ausführungsbefehls. |
Kernspeicher | Allgemein verfügbar |
az vm run-command update |
Der Vorgang zum Aktualisieren des Ausführungsbefehls. |
Kernspeicher | Allgemein verfügbar |
az vm run-command wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung des res virtual-machine-run-command erfüllt ist. |
Kernspeicher | Allgemein verfügbar |
az vm run-command create
Der Vorgang zum Erstellen des Ausführungsbefehls.
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]
Beispiele
Erstellen Sie einen Ausführungsbefehl.
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"
Erstellen Sie einen Ausführungsbefehl mit dem Hochladen des Skriptausgabedatenstroms in 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"
Erforderliche Parameter
Der Name des Befehls zum Ausführen des virtuellen Computers.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Der Name des virtuellen Computers.
Optionale Parameter
Optional. Wenn "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.
Geben Sie eine CommandId des vordefinierten integrierten Skripts an.
Geben Sie das Azure Storage-BLOB an, in das skriptfehlerdatenstrom hochgeladen wird.
Position Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Geben Sie den Azure Storage Blob (SAS-URI) an, in den der Skriptausgabedatenstrom hochgeladen wird.
Die vom Skript verwendeten Parameter.
Verwendung: --parameters arg1=XX arg2=XX.
Die vom Skript verwendeten Parameter.
Verwendung: --protected-parameters credentials=somefoo secret=somebar.
Kennwort bei Bedarf für die Verwendung des Run-as-User-Parameters. Sie wird verschlüsselt und nicht protokolliert.
Standardmäßig wird der Skriptprozess unter System-/Stammbenutzer ausgeführt. Geben Sie einen benutzerdefinierten Benutzer an, der den Prozess hosten soll.
Geben Sie den Skriptinhalt an, der auf der VM ausgeführt werden soll.
Geben Sie den Speicherort für den Skriptdownload an.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Das Timeout in Sekunden, um den Ausführungsbefehl auszuführen.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az vm run-command delete
Der Vorgang zum Löschen des Ausführungsbefehls.
az vm run-command delete --name
[--ids]
[--no-wait]
[--resource-group]
[--subscription]
[--vm-name]
[--yes]
Beispiele
Löschen eines Ausführungsbefehls.
az vm run-command delete --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vm-name "myVM"
Erforderliche Parameter
Der Name des Befehls zum Ausführen des virtuellen Computers.
Optionale Parameter
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Der Name des virtuellen Computers.
Nicht zur Bestätigung auffordern
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az vm run-command invoke
Führen Sie einen bestimmten Ausführungsbefehl auf einem virtuellen Computer aus.
az vm run-command show
gibt hilfreiche Informationen zu jedem Ausführungsbefehl zurück. Entdecken Sie run command-id's über az vmss run-command list
.
az vm run-command invoke --command-id
[--ids]
[--name]
[--no-wait]
[--parameters]
[--resource-group]
[--scripts]
[--subscription]
Beispiele
Installieren Sie nginx auf einer linux-VM.
az vm run-command invoke -g MyResourceGroup -n MyVm --command-id RunShellScript --scripts "sudo apt-get update && sudo apt-get install -y nginx"
Führen Sie den Shellbefehl auf einer linux-VM mit Parametern aus.
az vm run-command invoke -g MyResourceGroup -n MyVm --command-id RunShellScript --scripts 'echo $1 $2' --parameters hello world
Führen Sie powerShell-Skript auf einer Windows-VM mit Parametern aus. Inline bereitgestelltes Skript. Seien Sie vorsichtig von single-quoting 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'
Führen Sie powerShell-Skript auf einer Windows-VM mit Parametern aus. Skript, das aus der Datei bereitgestellt wird.
# 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"
Erforderliche Parameter
Die Befehls-ID.
Optionale Parameter
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Der Name des virtuellen Computers. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>
.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Leerzeichentrennte Parameter im Format "[name=]value".
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Durch Leerzeichen getrennte Skriptzeilen. Verwenden Sie @{file}, um skript aus einer Datei zu laden.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az vm run-command list
Führen Sie Befehle von einem virtuellen Computer oder einem Speicherort aus aus.
Sie können "--resource-group" und "--vm-name" angeben, um alle Ausführungsbefehle eines virtuellen Computers abzurufen. Sie können auch "--location" angeben, um alle verfügbaren Ausführungsbefehle für ein Abonnement an einem Ort auflisten zu können.
az vm run-command list [--expand]
[--location]
[--resource-group]
[--vm-name]
Beispiele
Auflisten von Ausführungsbefehlen auf einem virtuellen Computer.
az vm run-command list --resource-group "myResourceGroup" --vm-name "myVM"
Listet alle verfügbaren Ausführungsbefehle für ein Abonnement an einem Ort auf.
az vm run-command list --location "SoutheastAsia"
Optionale Parameter
Der erweiterungsausdruck, der für den Vorgang angewendet werden soll.
Position Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Der Name des virtuellen Computers.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az vm run-command show
Abrufen eines bestimmten Ausführungsbefehls.
Sie können "---resource-group", "--run-command-name" und "--vm-name" angeben, um den Ausführungsbefehl auf einem virtuellen Computer abzurufen. Sie können auch "--command-id" und "-location" angeben, um den Ausführungsbefehl für ein Abonnement an einem Ort abzurufen.
az vm run-command show [--command-id]
[--ids]
[--instance-view]
[--location]
[--name]
[--resource-group]
[--subscription]
[--vm-name]
Beispiele
Rufen Sie die Ausführungsbefehle auf einem virtuellen Computer ab.
az vm run-command show --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vm-name "myVM"
Abrufen eines bestimmten Ausführungsbefehls für ein Abonnement an einem Ort.
az vm run-command show --command-id "RunPowerShellScript" --location "SoutheastAsia"
Optionale Parameter
Die Befehls-ID.
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Die Instanzansicht eines Ausführungsbefehls.
Position Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Der Name des Befehls zum Ausführen des virtuellen Computers.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Der Name des virtuellen Computers.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az vm run-command update
Der Vorgang zum Aktualisieren des Ausführungsbefehls.
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]
Beispiele
Aktualisieren eines Ausführungsbefehls.
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"
Aktualisieren eines Ausführungsbefehls mit 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"
Erforderliche Parameter
Der Name des Befehls zum Ausführen des virtuellen Computers.
Optionale Parameter
Optional. Wenn "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.
Geben Sie eine CommandId des vordefinierten integrierten Skripts an.
Geben Sie das Azure Storage-BLOB an, in das skriptfehlerdatenstrom hochgeladen wird.
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Position Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Geben Sie den Azure Storage Blob (SAS-URI) an, in den der Skriptausgabedatenstrom hochgeladen wird.
Die vom Skript verwendeten Parameter.
Verwendung: --parameters arg1=XX arg2=XX.
Die vom Skript verwendeten Parameter.
Verwendung: --protected-parameters credentials=somefoo secret=somebar.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Kennwort bei Bedarf für die Verwendung des Run-as-User-Parameters. Sie wird verschlüsselt und nicht protokolliert.
Standardmäßig wird der Skriptprozess unter System-/Stammbenutzer ausgeführt. Geben Sie einen benutzerdefinierten Benutzer an, der den Prozess hosten soll.
Geben Sie den Skriptinhalt an, der auf der VM ausgeführt werden soll.
Geben Sie den Speicherort für den Skriptdownload an.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Das Timeout in Sekunden, um den Ausführungsbefehl auszuführen.
Der Name des virtuellen Computers.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az vm run-command wait
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung des res virtual-machine-run-command erfüllt ist.
az vm run-command wait [--command-id]
[--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--instance-view]
[--interval]
[--location]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
[--vm-name]
Optionale Parameter
Die Befehls-ID.
Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.
Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].
Warten Sie, bis sie gelöscht wurde.
Warten Sie, bis die Ressource vorhanden ist.
Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.
Die Instanzansicht eines Ausführungsbefehls.
Abrufintervall in Sekunden.
Position Werte aus: az account list-locations
. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location>
konfigurieren.
Der Name des Befehls zum Ausführen des virtuellen Computers.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Maximale Wartezeit in Sekunden.
Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.
Der Name des virtuellen Computers.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.