Freigeben über


az vm extension

Verwalten von Erweiterungen auf virtuellen Computern.

Erweiterungen sind kleine Anwendungen, die Konfiguration und Automatisierungsaufgaben nach der Bereitstellung 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

Name Beschreibung Typ Status
az vm extension delete

Löschvorgang zum Löschen der Erweiterung.

Kernspeicher Allgemein verfügbar
az vm extension image

Suchen Sie die verfügbaren VM-Erweiterungen für ein Abonnement und eine Region.

Kernspeicher Allgemein verfügbar
az vm extension image list

Listet die Informationen zu den verfügbaren Erweiterungen auf.

Kernspeicher Allgemein verfügbar
az vm extension image list-names

Listet die Namen der verfügbaren Erweiterungen auf.

Kernspeicher Allgemein verfügbar
az vm extension image list-versions

Listet die Versionen für verfügbare Erweiterungen auf.

Kernspeicher Allgemein verfügbar
az vm extension image show

Anzeigen von Informationen für eine Erweiterung.

Kernspeicher Allgemein verfügbar
az vm extension list

Auflisten der Erweiterungen, die an einen virtuellen Computer angefügt sind.

Kernspeicher Allgemein verfügbar
az vm extension set

Legen Sie Erweiterungen für einen virtuellen Computer fest.

Kernspeicher Allgemein verfügbar
az vm extension show

Zeigen Sie Informationen zu Erweiterungen an, die an einen virtuellen Computer angefügt sind.

Kernspeicher Allgemein verfügbar
az vm extension wait

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

Kernspeicher Allgemein verfügbar

az vm extension delete

Löschvorgang zum Löschen der Erweiterung.

az vm extension delete [--ids]
                       [--name]
                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                       [--resource-group]
                       [--subscription]
                       [--vm-name]

Beispiele

Verwenden Sie einen VIRTUELLEN Namen und eine Erweiterung, um eine Erweiterung von einem virtuellen Computer zu löschen.

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

Löschen Sie Erweiterungen mit IDs, die die Zeichenfolge "MyExtension" von 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). 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.

--name --vm-extension-name -n

Der Name der Erweiterung des virtuellen Computers.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Zulässige Werte: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

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

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

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

Auflisten der Erweiterungen, die an einen virtuellen Computer angefügt sind.

az vm extension list [--ids]
                     [--resource-group]
                     [--subscription]
                     [--vm-name]

Beispiele

Auflisten angefügter Erweiterungen an einen benannten virtuellen Computer.

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

Optionale Parameter

--ids

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.

--resource-group -g

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

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

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

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

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]
                    [--subscription]
                    [--version]
                    [--vm-name]

Beispiele

Fügen Sie einem virtuellen Linux-Computer ein Benutzerkonto hinzu.

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 benutzerdefinierteScript-Erweiterung zu virtuellen Computern hinzu, die durch --ids angegeben werden.

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 durch die 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 von der Plattform automatisch 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

Erzwingen Sie das Aktualisieren, auch wenn sich die Erweiterungskonfiguration nicht geändert hat.

Standardwert: False
--ids

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.

--no-auto-upgrade
Als veraltet markiert

Option "--no-auto-upgrade" ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "---no-auto-upgrade-minor-version".

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

Zulässige Werte: false, true
Standardwert: False
--no-auto-upgrade-minor-version

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

Zulässige Werte: false, true
Standardwert: False
--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--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.

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

--version

Die Version der Erweiterung. Zum Anheften der Erweiterungsversion an diesen Wert 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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

Zeigen Sie Informationen zu Erweiterungen an, die an einen virtuellen Computer angefügt sind.

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

Beispiele

Verwenden Sie vm-Name und Erweiterungsname, um die Erweiterungen anzuzeigen, die an eine VM angefügt sind.

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

Optionale Parameter

--ids

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.

--instance-view

Die Instanzansicht einer Erweiterung eines virtuellen Computers.

Standardwert: False
--name -n

Name der Erweiterung.

--resource-group -g

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

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

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

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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

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

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

Beispiele

Platzieren Sie die CLI in einem Wartezustand, bis eine Bedingung einer Erweiterung des 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 des 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 des 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 'Succeeded' erstellt wurde.

Standardwert: False
--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.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--ids

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.

--interval

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

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

--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
--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.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--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.