az connectedmachine run-command
Hinweis
Diese Referenz ist Teil der ConnectedMachine-Erweiterung für die Azure CLI (Version 2.49.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az connectedmachine-Run-Command-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen
Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Verwalten von Ausführungsbefehlen auf einem Azure Arc-Enabled-Server.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az connectedmachine run-command create |
Erstellen Sie einen Vorgang zum Erstellen oder Aktualisieren eines Ausführungsbefehls. |
Durchwahl | Vorschau |
az connectedmachine run-command delete |
Löschvorgang zum Löschen eines Ausführungsbefehls. |
Durchwahl | Vorschau |
az connectedmachine run-command list |
Listenvorgang zum Abrufen aller Ausführungsbefehle eines Nicht-Azure-Computers. |
Durchwahl | Vorschau |
az connectedmachine run-command show |
Abrufen eines Vorgangs zum Abrufen eines Ausführungsbefehls. |
Durchwahl | Vorschau |
az connectedmachine run-command update |
Aktualisieren Sie den Vorgang zum Erstellen oder Aktualisieren eines Ausführungsbefehls. |
Durchwahl | Vorschau |
az connectedmachine run-command wait |
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist. |
Durchwahl | Vorschau |
az connectedmachine run-command create
Die Befehlsgruppe "az connectedmachine run-command" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Erstellen Sie einen Vorgang zum Erstellen oder Aktualisieren eines Ausführungsbefehls.
az connectedmachine run-command create --machine-name
--name
--resource-group
[--async {0, 1, f, false, n, no, t, true, y, yes}]
[--command-id]
[--error-blob-managed-identity]
[--error-blob-uri]
[--location]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--output-blob-managed-identity]
[--output-blob-uri]
[--parameters]
[--password]
[--protected-parameters]
[--run-as-user]
[--script]
[--script-uri]
[--script-uri-managed-id]
[--tags]
[--timeout]
Beispiele
Beispielbefehl zum Erstellen von Befehlen
az connectedmachine run-command create --resource-group "myResourceGroup" --location "West US" --async false --parameters "[{"name":"param1","value":"value1"}]" --password "<runAsPassword>" --user "user1" --script "Write-Host Hello World!" --timeout 3600 --name "myRunCommand" --machine-name "myMachine" --subscription "mySubscription"
az connectedmachine run-command create --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --name "myRunCommand" --machine-name "myMachine" --output-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" --subscription "mySubscription"
Erforderliche Parameter
Der Name des Hybridcomputers.
Der Name des Ausführungsbefehls.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Optional. Wenn "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.
Gibt die CommandId des vordefinierten integrierten Skripts an.
Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf den FehlerBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zur verwalteten Identität und zum Ausführen von Befehlen finden Sie unter https://aka.ms/ManagedIdentityhttps://aka.ms/RunCommandManaged "Shorthand-Syntax", "json-file" und "yaml-file". Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt das Azure Storage-Blob an, bei dem der Skriptfehlerdatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf den Parameter "errorBlobManagedIdentity".
Der geografische Standort, an dem sich die Ressource befindet, wenn nicht angegeben, wird der Standort der Ressourcengruppe verwendet.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf outputBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zur verwalteten Identität und zum Ausführen von Befehlen finden Sie unter https://aka.ms/ManagedIdentityhttps://aka.ms/RunCommandManaged "Shorthand-Syntax", "json-file" und "yaml-file". Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt das Azure Storage-Blob an, in das der Skriptausgabedatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf outputBlobManagedIdentity-Parameter.
Die vom Skript verwendeten Parameter. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt das Benutzerkontokennwort auf dem Computer an, wenn der Ausführungsbefehl ausgeführt wird.
Die vom Skript verwendeten Parameter. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt das Benutzerkonto auf dem Computer an, wenn der Ausführungsbefehl ausgeführt wird.
Gibt den Skriptinhalt an, der auf dem Computer ausgeführt werden soll.
Gibt den Speicherort für den Skriptdownload an. Es kann entweder SAS-URI eines Azure Storage-Blobs mit Lesezugriff oder öffentlicher URI sein.
Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf ScriptUri im Falle eines Azure Storage-BLOB hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass das Azure Storage-Blob vorhanden ist, und die verwaltete Identität wurde zugriff auf den Container des Blobs mit der Rollenzuweisung "Storage Blob Data Reader" erhalten. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zur verwalteten Identität und zum Ausführen von Befehlen finden Sie unter https://aka.ms/ManagedIdentity und https://aka.ms/RunCommandManaged. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Ressourcentags. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
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 connectedmachine run-command delete
Die Befehlsgruppe "az connectedmachine run-command" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Löschvorgang zum Löschen eines Ausführungsbefehls.
az connectedmachine run-command delete [--ids]
[--machine-name]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--resource-group]
[--subscription]
[--yes]
Beispiele
Beispielbefehl zum Löschen von Befehlen
az connectedmachine run-command delete --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine"
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 Hybridcomputers.
Der Name des Ausführungsbefehls.
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.
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 connectedmachine run-command list
Die Befehlsgruppe "az connectedmachine run-command" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Listenvorgang zum Abrufen aller Ausführungsbefehle eines Nicht-Azure-Computers.
az connectedmachine run-command list --machine-name
--resource-group
[--expand]
Beispiele
Beispielbefehl für run-command list
az connectedmachine run-command list --resource-group "myResourceGroup" --machine-name "myMachine"
Erforderliche Parameter
Der Name des Hybridcomputers.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Optionale Parameter
Der erweiterungsausdruck, der für den Vorgang angewendet werden soll.
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 connectedmachine run-command show
Die Befehlsgruppe "az connectedmachine run-command" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Abrufen eines Vorgangs zum Abrufen eines Ausführungsbefehls.
az connectedmachine run-command show [--ids]
[--machine-name]
[--name]
[--resource-group]
[--subscription]
Beispiele
Beispielbefehl für die Ausführungsbefehlspräsentation
az connectedmahine run-command show --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine"
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 Hybridcomputers.
Der Name des Ausführungsbefehls.
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.
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 connectedmachine run-command update
Die Befehlsgruppe "az connectedmachine run-command" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Aktualisieren Sie den Vorgang zum Erstellen oder Aktualisieren eines Ausführungsbefehls.
az connectedmachine run-command update [--add]
[--async {0, 1, f, false, n, no, t, true, y, yes}]
[--error-blob-managed-identity]
[--error-blob-uri]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--machine-name]
[--name]
[--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
[--output-blob-managed-identity]
[--output-blob-uri]
[--parameters]
[--password]
[--protected-parameters]
[--remove]
[--resource-group]
[--run-as-user]
[--set]
[--source]
[--subscription]
[--tags]
[--timeout]
Beispiele
Beispielbefehl für ausführende Befehlsaktualisierung
az connetcedmachine run-command update --resource-group "myResourceGroup" --name "myRunCommand" --machine-name "myMachine" --subscription "mySubscription" --tags Tag1=Value1
Optionale Parameter
Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.
Optional. Wenn "true" festgelegt ist, wird die Bereitstellung abgeschlossen, sobald das Skript gestartet wird und nicht auf den Abschluss des Skripts wartet.
Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf den FehlerBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zur verwalteten Identität und zum Ausführen von Befehlen finden Sie unter https://aka.ms/ManagedIdentityhttps://aka.ms/RunCommandManaged "Shorthand-Syntax", "json-file" und "yaml-file". Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt das Azure Storage-Blob an, bei dem der Skriptfehlerdatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf den Parameter "errorBlobManagedIdentity".
Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.
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 Hybridcomputers.
Der Name des Ausführungsbefehls.
Nicht auf den Abschluss lang andauernder Vorgänge warten
Vom Benutzer zugewiesene verwaltete Identität, die Zugriff auf outputBlobUri-Speicherblob hat. Verwenden Sie ein leeres Objekt im Fall der vom System zugewiesenen Identität. Stellen Sie sicher, dass der Container eines Blobs mit der Rollenzuweisung "Storage Blob Data Contributor" auf verwaltete Identität zugreifen konnte. Stellen Sie bei der vom Benutzer zugewiesenen Identität sicher, dass Sie sie unter der Identität des virtuellen Computers hinzufügen. Weitere Informationen zur verwalteten Identität und zum Ausführen von Befehlen finden Sie unter https://aka.ms/ManagedIdentityhttps://aka.ms/RunCommandManaged "Shorthand-Syntax", "json-file" und "yaml-file". Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt das Azure Storage-Blob an, in das der Skriptausgabedatenstrom hochgeladen wird. Verwenden Sie einen SAS-URI mit Lese-, Anfüge-, Erstellungs-, Schreibzugriff ODER verwalteter Identität, um den VM-Zugriff auf das Blob bereitzustellen. Verweisen Sie auf outputBlobManagedIdentity-Parameter.
Die vom Skript verwendeten Parameter. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Gibt das Benutzerkontokennwort auf dem Computer an, wenn der Ausführungsbefehl ausgeführt wird.
Die vom Skript verwendeten Parameter. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name>
konfigurieren.
Gibt das Benutzerkonto auf dem Computer an, wenn der Ausführungsbefehl ausgeführt wird.
Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=.
Die Quelle des Ausführen-Befehlsskripts. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ressourcentags. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.
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 connectedmachine run-command wait
Die Befehlsgruppe "az connectedmachine run-command" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung erfüllt ist.
az connectedmachine run-command wait [--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--machine-name]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
Optionale Parameter
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.
Abrufintervall in Sekunden.
Der Name des Hybridcomputers.
Der Name des Ausführungsbefehls.
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.
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.
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für