az vm extension

Referenz

Verwalten von Erweiterungen auf VMs.

Erweiterungen sind kleine Anwendungen, die Nachbereitstellungskonfigurations- und Automatisierungsaufgaben auf virtuellen Azure-Computern bereitstellen. Wenn z.B. Software auf einem virtuellen Computer installiert werden muss, Virenschutz oder eine Docker-Konfiguration erforderlich ist, kann eine VM-Erweiterung zum Ausführen dieser Aufgaben verwendet werden. Erweiterungen können mit einer neuen Bereitstellung für virtuelle Computer gebündelt oder in Bezug auf ein bestehendes System ausgeführt werden.

Befehle

az vm extension delete	Entfernen sie eine Erweiterung, die an eine VM angefügt ist.
az vm extension image	Suchen Sie die verfügbaren VM-Erweiterungen für ein Abonnement und eine Region.
az vm extension image list	Listet die Informationen zu verfügbaren Erweiterungen auf.
az vm extension image list-names	Listet die Namen der verfügbaren Erweiterungen auf.
az vm extension image list-versions	Listet die Versionen für verfügbare Erweiterungen auf.
az vm extension image show	Anzeigen von Informationen für eine Erweiterung
az vm extension list	Listet die Erweiterungen auf, die an einen virtuellen Computer angefügt sind.
az vm extension set	Legen Sie Erweiterungen für einen virtuellen Computer fest.
az vm extension show	Zeigen Sie Informationen zu Erweiterungen an, die an eine VM angefügt sind.
az vm extension wait	Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Erweiterung eines virtuellen Computers erfüllt ist.

az vm extension delete

Bearbeiten

Entfernen sie eine Erweiterung, die an eine VM angefügt ist.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait]
                       [--resource-group]
                       [--vm-name]

Beispiele

Verwenden Sie einen VIRTUELLEN Namen und eine Erweiterung, um eine Erweiterung von einer VM zu löschen.

az vm extension delete -g MyResourceGroup --vm-name MyVm -n extension_name

Löschen Sie Erweiterungen mit IDs, die die Zeichenfolge "MyExtension" aus einer VM enthalten.

az vm extension delete --ids \
    $(az resource list --query "[?contains(name, 'MyExtension')].id" -o tsv)

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.

--name -n

Name der Erweiterung.

--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. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

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

Bearbeiten

Listet die Erweiterungen auf, die an einen virtuellen Computer angefügt sind.

az vm extension list --resource-group
                     --vm-name

Beispiele

Listet angefügte Erweiterungen auf einer benannten VM auf.

az vm extension list -g MyResourceGroup --vm-name MyVm

Erforderliche Parameter

--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. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

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

Bearbeiten

Legen Sie Erweiterungen für einen virtuellen Computer fest.

Abrufen von Erweiterungsdetails von az vm extension image list.

az vm extension set --name
                    --publisher
                    [--enable-auto-upgrade {false, true}]
                    [--extension-instance-name]
                    [--force-update]
                    [--ids]
                    [--no-auto-upgrade {false, true}]
                    [--no-auto-upgrade-minor-version {false, true}]
                    [--no-wait]
                    [--protected-settings]
                    [--resource-group]
                    [--settings]
                    [--version]
                    [--vm-name]

Beispiele

Hinzufügen eines Benutzerkontos zu einer Linux-VM.

az vm extension set -n VMAccessForLinux --publisher Microsoft.OSTCExtensions --version 1.4 \
    --vm-name MyVm --resource-group MyResourceGroup \
    --protected-settings '{"username":"user1", "ssh_key":"ssh_rsa ..."}'

Fügen Sie eine customScript-Erweiterung zu vm(n) hinzu, die von --ids angegeben wird.

az vm extension set -n customScript --publisher Microsoft.Azure.Extensions --ids {vm_id}

Fügen Sie eine Erweiterung hinzu, und aktivieren Sie das automatische Upgrade der Plattform, wenn eine neuere Version der Erweiterung verfügbar ist.

az vm extension set -n extName --publisher publisher --vm-name MyVM -g MyResourceGroup \
--enable-auto-upgrade true

Erforderliche Parameter

--name -n

Name der Erweiterung.

Wert aus: az vm extension image list

--publisher

Der Name des Erweiterungsherausgebers.

Optionale Parameter

--enable-auto-upgrade

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

Zulässige Werte: false, true

--extension-instance-name

Name der Erweiterungsinstanz, die angepasst werden kann. Standard: Name der Erweiterung.

--force-update

Erzwingt die Aktualisierung, auch wenn die Erweiterungskonfiguration nicht geändert wurde.

--ids

--no-auto-upgrade

Wenn festgelegt, wählt der Erweiterungsdienst nicht automatisch die neueste Nebenversion aus, auch wenn die Erweiterung erneut bereitgestellt wird.

Zulässige Werte: false, true

--no-auto-upgrade-minor-version

Wenn festgelegt, wählt der Erweiterungsdienst nicht automatisch die neueste Nebenversion aus, auch wenn die Erweiterung erneut bereitgestellt wird.

Zulässige Werte: false, true

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

--protected-settings

Geschützte Einstellungen im JSON-Format für vertrauliche Informationen wie Anmeldeinformationen. Ein JSON-Dateipfad wird ebenfalls akzeptiert.

--resource-group -g

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

--settings

Erweiterungseinstellungen im JSON-Format. Ein JSON-Dateipfad wird ebenfalls akzeptiert.

--version

Die Version der Erweiterung. Um die Erweiterungsversion an diesen Wert anzuheften, geben Sie bitte --no-auto-upgrade-minor-version an.

--vm-name

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

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

Bearbeiten

Zeigen Sie Informationen zu Erweiterungen an, die an eine VM angefügt sind.

az vm extension show [--expand]
                     [--ids]
                     [--instance-view]
                     [--name]
                     [--resource-group]
                     [--vm-name]

Beispiele

Verwenden Sie vm-Name und Erweiterungsname, um die Erweiterungen anzuzeigen, die an einen virtuellen Computer angefügt sind.

az vm extension show -g MyResourceGroup --vm-name MyVm -n extension_name

Optionale Parameter

--expand

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

--ids

--instance-view

Die Instanzansicht einer Erweiterung eines virtuellen Computers.

--name -n

Name der Erweiterung.

--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. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

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

Bearbeiten

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Erweiterung eines virtuellen Computers erfüllt ist.

az vm extension wait [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--expand]
                     [--ids]
                     [--interval]
                     [--name]
                     [--resource-group]
                     [--timeout]
                     [--updated]
                     [--vm-name]

Beispiele

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Erweiterung eines virtuellen Computers erfüllt ist. (automatisch generiert)

az vm extension wait --created --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Erweiterung eines virtuellen Computers erfüllt ist. (automatisch generiert)

az vm extension wait --exists --name MyExtension --resource-group MyResourceGroup --vm-name MyVm

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Erweiterung eines virtuellen Computers erfüllt ist. (automatisch generiert)

az vm extension wait --ids @- --name MyExtension --subscription MySubscription --updated --vm-name MyVm

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.

--expand

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

--ids

--interval

Abfrageintervall in Sekunden.

Standardwert: 30

--name -n

Name der Erweiterung.

--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. Sie können die Standardeinstellung mithilfe von az configure --defaults vm=<name>.

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 extension

Befehle

az vm extension delete

Beispiele

Optionale Parameter

az vm extension list

Beispiele

Erforderliche Parameter

az vm extension set

Beispiele

Erforderliche Parameter

Optionale Parameter

az vm extension show

Beispiele

Optionale Parameter

az vm extension wait

Beispiele

Optionale Parameter

Feedback