Freigeben über

az vmss extension

  • Referenz

Verwalten von Erweiterungen in einem VM-Skalierungssatz.

Befehle

Name Beschreibung Typ Status
az vmss extension delete

Löschen Einer Erweiterung aus einem VMSS.

 Kernspeicher Allgemein verfügbar
az vmss extension image

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

 Kernspeicher Allgemein verfügbar
az vmss extension image list

Listet die Informationen zu den verfügbaren Erweiterungen auf.

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

Auflisten von Imagetypen für Erweiterungsimages für virtuelle Computer.

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

Auflisten der Imageversionen der Erweiterung virtueller Computer.

 Kernspeicher Allgemein verfügbar
az vmss extension image show

Abrufen eines Erweiterungsimages für virtuelle Computer.

 Kernspeicher Allgemein verfügbar
az vmss extension list

Listet Erweiterungen auf, die einem VMSS zugeordnet sind.

 Kernspeicher Allgemein verfügbar
az vmss extension set

Fügen Sie einer VMSS eine Erweiterung hinzu, oder aktualisieren Sie eine vorhandene Erweiterung.

 Kernspeicher Allgemein verfügbar
az vmss extension show

Details zu einer VMSS-Erweiterung anzeigen.

 Kernspeicher Allgemein verfügbar
az vmss extension upgrade

Aktualisieren Sie alle Erweiterungen für alle VMSS-Instanzen auf die neueste Version.

 Kernspeicher Allgemein verfügbar

az vmss extension delete

Bearbeiten

Löschen Einer Erweiterung aus einem VMSS.

az vmss extension delete --name
                         --resource-group
                         --vmss-name
                         [--no-wait]

Beispiele

Löschen Einer Erweiterung aus einem VMSS. (automatisch generiert)

az vmss extension delete --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

Erforderliche Parameter

--name -n

Name der Erweiterung.

--resource-group -g

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

--vmss-name

Skalierungssatzname. Sie können die Standardeinstellung mithilfe von az configure --defaults vmss=<name>.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
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 vmss extension list

Bearbeiten

Listet Erweiterungen auf, die einem VMSS zugeordnet sind.

az vmss extension list --resource-group
                       --vmss-name

Beispiele

Listet Erweiterungen auf, die einem VMSS zugeordnet sind. (automatisch generiert)

az vmss extension list --resource-group MyResourceGroup --vmss-name MyVmss

Erforderliche Parameter

--resource-group -g

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

--vmss-name

Skalierungssatzname. Sie können die Standardeinstellung mithilfe von az configure --defaults vmss=<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 vmss extension set

Bearbeiten

Fügen Sie einer VMSS eine Erweiterung hinzu, oder aktualisieren Sie eine vorhandene Erweiterung.

Abrufen von Erweiterungsdetails von az vmss extension image list.

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

Beispiele

Legen Sie eine Erweiterung fest, die von zwei zuvor festgelegten Erweiterungen abhängt. Das heißt, wenn eine VMSS-Instanz erstellt oder umgestellt wird, wird die customScript-Erweiterung erst bereitgestellt, nachdem alle Erweiterungen bereitgestellt wurden, von denen sie abhängt. Die Erweiterung muss nicht von den anderen Erweiterungen für erforderliche Konfigurationen abhängen.

az vmss extension set --vmss-name my-vmss --name customScript --resource-group my-group \
    --version 2.0 --publisher Microsoft.Azure.Extensions \
    --provision-after-extensions NetworkWatcherAgentLinux VMAccessForLinux  \
    --settings '{"commandToExecute": "echo testing"}'

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 vmss extension set -n extName --publisher publisher --vmss-name my-vmss -g my-group \ --enable-auto-upgrade true

Erforderliche Parameter

--name -n

Name der Erweiterung.

Wert aus: az vm extension image list
--publisher

Der Name des Erweiterungsherausgebers.

--resource-group -g

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

--vmss-name

Skalierungssatzname. Sie können die Standardeinstellung mithilfe von az configure --defaults vmss=<name>.

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

--provision-after-extensions

Durch Leerzeichen getrennte Liste der Erweiterungsnamen, nach denen diese Erweiterung bereitgestellt werden soll. Diese Erweiterungen müssen bereits auf dem virtuellen Computer festgelegt werden.

--settings

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

--version

Die Version der Erweiterung. Zum Anheften der Erweiterungsversion an diesen Wert geben Sie bitte "--no-auto-upgrade-minor-version" 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.

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

Bearbeiten

Details zu einer VMSS-Erweiterung anzeigen.

az vmss extension show --name
                       --resource-group
                       --vmss-name

Beispiele

Details zu einer VMSS-Erweiterung anzeigen. (automatisch generiert)

az vmss extension show --name MyExtension --resource-group MyResourceGroup --vmss-name MyVmss

Erforderliche Parameter

--name -n

Name der Erweiterung.

--resource-group -g

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

--vmss-name

Skalierungssatzname. Sie können die Standardeinstellung mithilfe von az configure --defaults vmss=<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 vmss extension upgrade

Bearbeiten

Aktualisieren Sie alle Erweiterungen für alle VMSS-Instanzen auf die neueste Version.

az vmss extension upgrade [--ids]
                          [--name]
                          [--no-wait]
                          [--resource-group]
                          [--subscription]

Beispiele

Aktualisieren Sie alle Erweiterungen auf die neueste Version.

az vmss extension upgrade -g MyResourceGroup -n MyVmss

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

Skalierungssatzname. Sie können die Standardeinstellung mithilfe von az configure --defaults vmss=<name>.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

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

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.