az vm run-command

Referenz

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

az vm run-command create	Der Vorgang zum Erstellen des Befehls "Ausführen".
az vm run-command delete	Der Vorgang zum Löschen des Befehls "Ausführen".
az vm run-command invoke	Führen Sie einen bestimmten Ausführungsbefehl auf einem virtuellen Computer aus.
az vm run-command list	Der Vorgang zum Abrufen aller Ausführungsbefehle eines virtuellen Computers. Und listet alle verfügbaren Ausführungsbefehle für ein Abonnement an einem Ort auf.
az vm run-command show	Der Vorgang zum Abrufen des Befehls "Ausführen". Und ruft den spezifischen Ausführungsbefehl für ein Abonnement an einem Speicherort ab.
az vm run-command update	Der Vorgang zum Aktualisieren des Ausführungsbefehls.
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 create

Bearbeiten

Der Vorgang zum Erstellen des Befehls "Ausführen".

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 Befehl zum Ausführen.

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"

Erforderliche Parameter

--name --run-command-name

Der Name des Befehls zum Ausführen des virtuellen Computers.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--vm-name

Der Name des virtuellen Computers.

Optionale Parameter

--async-execution

Optional. Wenn dies auf "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.

Zulässige Werte: false, true

--command-id

Geben Sie eine CommandId des vordefinierten integrierten Skripts an.

--error-blob-uri

Geben Sie den Azure-Speicher-Blob an, in den Skriptfehlerdatenstrom hochgeladen wird.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--output-blob-uri

Geben Sie den Azure-Speicher-Blob an, in dem skriptausgabedatenstrom hochgeladen wird.

--parameters

Die parameter, die vom Skript verwendet werden.

--protected-parameters

Die parameter, die vom Skript verwendet werden.

--run-as-password

Kennwort bei Bedarf für die Verwendung des Parameters "run-as-user". Es wird verschlüsselt und nicht protokolliert.

--run-as-user

Standardmäßig wird der Skriptprozess unter System/Stammbenutzer ausgeführt. Geben Sie einen benutzerdefinierten Benutzer an, der den Prozess hosten soll.

--script

Geben Sie den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll.

--script-uri

Geben Sie den Speicherort des Skriptdownloads an.

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--timeout-in-seconds

Das Timeout in Sekunden, um den Ausführungsbefehl auszuführen.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az vm run-command delete

Bearbeiten

Der Vorgang zum Löschen des Befehls "Ausführen".

az vm run-command delete --name
                         [--ids]
                         [--no-wait]
                         [--resource-group]
                         [--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

--name --run-command-name

Der Name des Befehls zum Ausführen des virtuellen Computers.

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen von Argumenten der Ressource-ID enthält. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--vm-name

Der Name des virtuellen Computers.

--yes -y

Nicht zur Bestätigung auffordern

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az vm run-command invoke

Bearbeiten

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 die Befehls-ID von "Ausführen" über az vmss run-command list.

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

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. Skript bereitgestellt inline. Seien Sie vorsichtig mit einer einmaligen Zitatierung 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

--command-id

Die Befehls-ID.

Wert aus: az vm run-command list

Optionale Parameter

--ids

--name -n

Der Name des virtuellen Computers. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

--parameters

Leertrennte Parameter im Format "[name=]value".

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--scripts

Leerzeichentrennte Skriptzeilen. Verwenden Sie "@{file}", um Skript aus einer Datei zu laden.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az vm run-command list

Bearbeiten

Der Vorgang zum Abrufen aller Ausführungsbefehle eines virtuellen Computers. Und listet alle verfügbaren Ausführungsbefehle für ein Abonnement an einem Ort auf.

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

Beispiele

Befehle in einem virtuellen Computer auflisten.

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

Alle verfügbaren Ausführungsbefehle für ein Abonnement an einem Speicherort auflisten.

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

Optionale Parameter

--expand

Der erweiterungsausdruck, der für den Vorgang angewendet werden soll.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--vm-name

Der Name des virtuellen Computers.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az vm run-command show

Bearbeiten

Der Vorgang zum Abrufen des Befehls "Ausführen". Und ruft den spezifischen Ausführungsbefehl für ein Abonnement an einem Speicherort ab.

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

Beispiele

Rufen Sie die Ausführungsbefehle auf dem virtuellen Computer ab.

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

Abrufen des spezifischen Ausführungsbefehls für ein Abonnement an einem Speicherort.

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

Optionale Parameter

--command-id

Die Befehls-ID.

--expand

Der erweiterungsausdruck, der für den Vorgang angewendet werden soll.

--ids

--instance-view

Die Instanzansicht eines Ausführungsbefehls.

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name --run-command-name

Der Name des Befehls zum Ausführen des virtuellen Computers.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--vm-name

Der Name des virtuellen Computers.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az vm run-command update

Bearbeiten

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]
                         [--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"

Erforderliche Parameter

--name --run-command-name

Der Name des Befehls zum Ausführen des virtuellen Computers.

Optionale Parameter

--async-execution

Optional. Wenn dies auf "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.

Zulässige Werte: false, true

--command-id

Geben Sie eine CommandId des vordefinierten integrierten Skripts an.

--error-blob-uri

Geben Sie den Azure-Speicher-Blob an, in den Skriptfehlerdatenstrom hochgeladen wird.

--ids

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--output-blob-uri

Geben Sie den Azure-Speicher-Blob an, in dem skriptausgabedatenstrom hochgeladen wird.

--parameters

Die parameter, die vom Skript verwendet werden.

--protected-parameters

Die parameter, die vom Skript verwendet werden.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--run-as-password

Kennwort bei Bedarf für die Verwendung des Parameters "run-as-user". Es wird verschlüsselt und nicht protokolliert.

--run-as-user

Standardmäßig wird der Skriptprozess unter System/Stammbenutzer ausgeführt. Geben Sie einen benutzerdefinierten Benutzer an, der den Prozess hosten soll.

--script

Geben Sie den Skriptinhalt an, der auf dem virtuellen Computer ausgeführt werden soll.

--script-uri

Geben Sie den Speicherort des Skriptdownloads an.

--tags

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--timeout-in-seconds

Das Timeout in Sekunden, um den Ausführungsbefehl auszuführen.

--vm-name

Der Name des virtuellen Computers.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az vm run-command wait

Bearbeiten

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]
                       [--expand]
                       [--ids]
                       [--instance-view]
                       [--interval]
                       [--location]
                       [--name]
                       [--resource-group]
                       [--timeout]
                       [--updated]
                       [--vm-name]

Optionale Parameter

--command-id

Die Befehls-ID.

--created

Warten Sie, bis Sie mit "provisioningState" unter "Erfolgreich" erstellt wurden.

--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

--exists

Warten Sie, bis die Ressource vorhanden ist.

--expand

Der erweiterungsausdruck, der für den Vorgang angewendet werden soll.

--ids

--instance-view

Die Instanzansicht eines Ausführungsbefehls.

--interval

Abfrageintervall in Sekunden.

Standardwert: 30

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name --run-command-name

Der Name des Befehls zum Ausführen des virtuellen Computers.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600

--updated

Warten Sie, bis die Aktualisierung mit provisioningState unter "Erfolgreich" ausgeführt wurde.

--vm-name

Der Name des virtuellen Computers.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az vm run-command

Befehle

az vm run-command create

Beispiele

Erforderliche Parameter

Optionale Parameter

az vm run-command delete

Beispiele

Erforderliche Parameter

Optionale Parameter

az vm run-command invoke

Beispiele

Erforderliche Parameter

Optionale Parameter

az vm run-command list

Beispiele

Optionale Parameter

az vm run-command show

Beispiele

Optionale Parameter

az vm run-command update

Beispiele

Erforderliche Parameter

Optionale Parameter

az vm run-command wait

Optionale Parameter

Feedback