Freigeben über

az scvmm vm extension

  • Referenz

Hinweis

Diese Referenz ist Teil der Scvmm-Erweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az scvmm vm-Erweiterungsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten sie die VM-Erweiterung mit scvmm.

Befehle

Name Beschreibung Typ Status
az scvmm vm extension create

Der Vorgang zum Erstellen der Erweiterung.

 Durchwahl Allgemein verfügbar
az scvmm vm extension delete

Der Vorgang zum Löschen der Erweiterung.

 Durchwahl Allgemein verfügbar
az scvmm vm extension list

Der Vorgang zum Abrufen aller Erweiterungen eines virtuellen Computers ohne Azure.

 Durchwahl Allgemein verfügbar
az scvmm vm extension show

Der Vorgang zum Abrufen der Erweiterung.

 Durchwahl Allgemein verfügbar
az scvmm vm extension update

Der Vorgang zum Aktualisieren der Erweiterung.

 Durchwahl Allgemein verfügbar

az scvmm vm extension create

Der Vorgang zum Erstellen der Erweiterung.

az scvmm vm extension create --location
                             --name
                             --resource-group
                             --vm-name
                             [--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 einer VM-Erweiterung

az scvmm vm extension create --name contoso-extension --location eastus2euap --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -gt 10000 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

Erforderliche Parameter

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--name

Der Name der VM-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, auf dem die Erweiterung erstellt oder aktualisiert werden soll.

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

Gibt 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 aktualisiert werden soll, auch wenn sich die Erweiterungskonfiguration nicht geändert hat.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--protected-settings

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

--publisher

Der Name des Herausgebers des Erweiterungshandlers.

--settings

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

--tags

Durch Leerzeichen getrennte 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

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

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 scvmm vm extension delete

Der Vorgang zum Löschen der Erweiterung.

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

Beispiele

Löschen einer VM-Erweiterung

az scvmm vm extension delete --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

Der Name der VM-Erweiterung.

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

--vm-name

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

--yes -y

Nicht zur Bestätigung auffordern

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

Der Vorgang zum Abrufen aller Erweiterungen eines virtuellen Computers ohne Azure.

az scvmm vm extension list --resource-group
                           --vm-name
                           [--expand]

Beispiele

Abrufen aller VM-Erweiterungen

az scvmm vm extension list --vm-name contoso-vm --resource-group contoso-rg

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, der die Erweiterung enthält.

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.

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

Der Vorgang zum Abrufen der Erweiterung.

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

Beispiele

VM-Erweiterung abrufen

az scvmm vm extension show --name contoso-extension --vm-name contoso-vm --resource-group contoso-rg

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

Der Name der VM-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, der die Erweiterung enthält.

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 scvmm vm extension update

Der Vorgang zum Aktualisieren der Erweiterung.

az scvmm vm extension update --name
                             --resource-group
                             --vm-name
                             [--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

Aktualisieren einer VM-Erweiterung

az scvmm vm extension update --name contoso-extension --type CustomScriptExtension --publisher Microsoft.Compute --settings "{\"commandToExecute\":\"powershell.exe -c \\\"Get-Process | Where-Object { $_.CPU -lt 100 }\\\"\"}" --type-handler-version 1.10 --vm-name contoso-vm --resource-group contoso-rg

Erforderliche Parameter

--name

Der Name der VM-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, auf dem die Erweiterung erstellt oder aktualisiert werden soll.

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

Gibt 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 aktualisiert werden soll, auch wenn sich die Erweiterungskonfiguration nicht geändert hat.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--protected-settings

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

--publisher

Der Name des Herausgebers des Erweiterungshandlers.

--settings

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

--tags

Durch Leerzeichen getrennte 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

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

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.