az connectedmachine extension

Hinweis

Dieser Verweis ist Teil der VerbundenenMachine-Erweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird beim ersten Ausführen eines az connectedmachine-Erweiterungsbefehls automatisch installiert. Weitere Informationen zu Erweiterungen

Verwalten der Maschinenerweiterung mit verbundenen Maschinen.

Befehle

az connectedmachine extension create	Der Vorgang zum Erstellen der Erweiterung.
az connectedmachine extension delete	Der Vorgang zum Löschen der Erweiterung.
az connectedmachine extension list	Der Vorgang zum Abrufen aller Erweiterungen eines Nicht-Azure-Computers.
az connectedmachine extension show	Der Vorgang zum Abrufen der Erweiterung.
az connectedmachine extension update	Der Vorgang zum Erstellen oder Aktualisieren der Erweiterung.
az connectedmachine extension wait	Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung der verbundenen Maschinenerweiterung erfüllt ist.

az connectedmachine extension create

Der Vorgang zum Erstellen der Erweiterung.

az connectedmachine extension create --machine-name
                                     --name
                                     --resource-group
                                     [--auto-upgrade-minor {false, true}]
                                     [--enable-auto-upgrade {false, true}]
                                     [--force-update-tag]
                                     [--inst-handler-version]
                                     [--instance-view-type]
                                     [--location]
                                     [--no-wait]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--status]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Beispiele

Erstellen oder Aktualisieren einer Computererweiterung

az connectedmachine extension create --name "CustomScriptExtension" --location "eastus2euap" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings '{"commandToExecute":"hostname"}' --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Erforderliche Parameter

--machine-name

Der Name des Computers, auf dem die Erweiterung erstellt oder aktualisiert werden soll.

--name

Der Name der Computererweiterung.

--resource-group -g

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

Optionale Parameter

--auto-upgrade-minor

Geben Sie an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst wenn diese Eigenschaft auf „true“ festgelegt ist.

Zulässige Werte: false, true

--enable-auto-upgrade

Geben Sie an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version verfügbar ist.

Zulässige Werte: false, true

--force-update-tag

Wie der Erweiterungshandler gezwungen werden sollte, auch dann zu aktualisieren, wenn die Erweiterungskonfiguration nicht geändert wurde.

--inst-handler-version

Geben Sie die Version des Skripthandlers an.

--instance-view-type

Geben Sie den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".

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

--protected-settings

Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. Erwarteter Wert: json-string/json-file/@json-file.

--publisher

Der Name des Erweiterungshandler-Herausgebers.

--settings

Json formatierte öffentliche Einstellungen für die Erweiterung. Erwarteter Wert: json-string/json-file/@json-file.

--status

Status der Instanzansicht.

--tags

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

--type

Geben Sie den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".

--type-handler-version

Geben Sie die Version des Skripthandlers an.

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 connectedmachine extension delete

Der Vorgang zum Löschen der Erweiterung.

az connectedmachine extension delete --machine-name
                                     --name
                                     --resource-group
                                     [--no-wait]
                                     [--yes]

Beispiele

Löschen einer Computererweiterung

az connectedmachine extension delete --name "MMA" --machine-name "myMachine" --resource-group "myResourceGroup"

Erforderliche Parameter

--machine-name

Der Name des Computers, auf dem die Erweiterung gelöscht werden soll.

--name

Der Name der Computererweiterung.

--resource-group -g

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

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--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 connectedmachine extension list

Der Vorgang zum Abrufen aller Erweiterungen eines Nicht-Azure-Computers.

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]

Beispiele

Abrufen aller Computererweiterungen

az connectedmachine extension list --machine-name "myMachine" --resource-group "myResourceGroup"

Erforderliche Parameter

--machine-name

Der Name des Computers, der die Erweiterung enthält.

--resource-group -g

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

Optionale Parameter

--expand

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

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 connectedmachine extension show

Der Vorgang zum Abrufen der Erweiterung.

az connectedmachine extension show --machine-name
                                   --name
                                   --resource-group

Beispiele

Computererweiterung abrufen

az connectedmachine extension show --name "CustomScriptExtension" --machine-name "myMachine" --resource-group "myResourceGroup"

Erforderliche Parameter

--machine-name

Der Name des Computers, der die Erweiterung enthält.

--name

Der Name der Computererweiterung.

--resource-group -g

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

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 connectedmachine extension update

Der Vorgang zum Erstellen oder Aktualisieren der Erweiterung.

az connectedmachine extension update --machine-name
                                     --name
                                     --resource-group
                                     [--auto-upgrade-minor {false, true}]
                                     [--enable-auto-upgrade {false, true}]
                                     [--force-update-tag]
                                     [--no-wait]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Beispiele

Erstellen oder Aktualisieren einer Computererweiterung

az connectedmachine extension update --name "CustomScriptExtension" --type "CustomScriptExtension" --publisher "Microsoft.Compute" --settings '{"commandToExecute":"hostname"}' --type-handler-version "1.10" --machine-name "myMachine" --resource-group "myResourceGroup"

Erforderliche Parameter

--machine-name

Der Name des Computers, auf dem die Erweiterung erstellt oder aktualisiert werden soll.

--name

Der Name der Computererweiterung.

--resource-group -g

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

Optionale Parameter

--auto-upgrade-minor

Geben Sie an, ob die Erweiterung eine neuere Nebenversion verwenden soll, wenn sie zur Bereitstellungszeit verfügbar ist. Abgesehen von erneuten Bereitstellungen führt die Erweiterung nach der Bereitstellung jedoch keine Upgrades für Nebenversionen aus, selbst wenn diese Eigenschaft auf „true“ festgelegt ist.

Zulässige Werte: false, true

--enable-auto-upgrade

Geben Sie an, ob die Erweiterung automatisch von der Plattform aktualisiert werden soll, wenn eine neuere Version verfügbar ist.

Zulässige Werte: false, true

--force-update-tag

Wie der Erweiterungshandler gezwungen werden sollte, auch dann zu aktualisieren, wenn die Erweiterungskonfiguration nicht geändert wurde.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--protected-settings

Die Erweiterung kann entweder protectedSettings oder protectedSettingsFromKeyVault oder gar keine geschützten Einstellungen enthalten. Erwarteter Wert: json-string/json-file/@json-file.

--publisher

Der Name des Erweiterungshandler-Herausgebers.

--settings

Json formatierte öffentliche Einstellungen für die Erweiterung. Erwarteter Wert: json-string/json-file/@json-file.

--tags

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

--type

Geben Sie den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".

--type-handler-version

Geben Sie die Version des Skripthandlers an.

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 connectedmachine extension wait

Platzieren Sie die CLI in einem Wartezeitzustand, bis eine Bedingung der verbundenen Maschinenerweiterung erfüllt ist.

az connectedmachine extension wait --machine-name
                                   --name
                                   --resource-group
                                   [--created]
                                   [--custom]
                                   [--deleted]
                                   [--exists]
                                   [--interval]
                                   [--timeout]
                                   [--updated]

Beispiele

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die verbundene Maschinenerweiterung erfolgreich erstellt wurde.

az connectedmachine extension wait --name "CustomScriptExtension" --machine-name "myMachine" --resource-group "myResourceGroup" --created

Anhalten der Ausführung der nächsten Cli-Skriptzeile, bis die verbundene Maschinenerweiterung erfolgreich aktualisiert wird.

az connectedmachine extension wait --name "CustomScriptExtension" --machine-name "myMachine" --resource-group "myResourceGroup" --updated

Anhalten der Ausführung der nächsten Zeile des CLI-Skripts, bis die verbundene Maschinenerweiterung erfolgreich gelöscht wird.

az connectedmachine extension wait --name "CustomScriptExtension" --machine-name "myMachine" --resource-group "myResourceGroup" --deleted

Erforderliche Parameter

--machine-name

Der Name des Computers, der die Erweiterung enthält.

--name

Der Name der Computererweiterung.

--resource-group -g

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

Optionale Parameter

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

--interval

Abfrageintervall in Sekunden.

Standardwert: 30

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600

--updated

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

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.