az maintenance configuration

  • Referenz

Hinweis

Diese Referenz ist Teil der erweiterung Standard tenance für die Azure CLI (Version 2.56.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az Standard tenance-Konfigurationsbefehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Verwalten Sie Standard tenance-Konfiguration mit Standard anz.

Befehle

Name Beschreibung Typ Status
az maintenance configuration create

Erstellen Sie einen Konfigurationsdatensatz.

 Erweiterung Allgemein verfügbar
az maintenance configuration delete

Konfigurationsdatensatz löschen.

 Erweiterung Allgemein verfügbar
az maintenance configuration list

Auflisten von Konfigurationsdatensätzen innerhalb einer Abonnement- und Ressourcengruppe.

 Erweiterung Allgemein verfügbar
az maintenance configuration show

Abrufen des Konfigurationsdatensatzes.

 Erweiterung Allgemein verfügbar
az maintenance configuration update

Aktualisieren des Konfigurationsdatensatzes.

 Erweiterung Allgemein verfügbar

az maintenance configuration create

Erstellen Sie einen Konfigurationsdatensatz.

az maintenance configuration create --name
                                    --resource-group
                                    [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--tags]
                                    [--visibility {Custom, Public}]

Beispiele

MaintenanceConfigurations_CreateOrUpdateForResource

az maintenance configuration create --location "westus2" --maintenance-scope "OSImage" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Day" --maintenance-window-start-date-time "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

Erforderliche Parameter

--name --resource-name -n

Name der Wartungskonfiguration.

--resource-group -g

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

Optionale Parameter

--duration --maintenance-window-duration

Dauer des Wartungsfensters im hh:mm-Format. Wenn nicht angegeben, wird der Standardwert basierend auf dem bereitgestellten Wartungsbereich verwendet. z. B. 05:00.

--expiration-date-time --maintenance-window-expiration-date-time

Effektives Ablaufdatum des Wartungsfensters im JJJJ-MM-TT hh:mm-Format. Das Fenster wird in der angegebenen Zeitzone erstellt und an die entsprechende Sommerzeit dieser Zeitzone angepasst. Das Ablaufdatum muss auf ein Datum in der Zukunft festgelegt werden. Ohne Angabe wird es auf den maximalen Zeitpunkt (9999-12-31 23:59:59) festgelegt.

--extension-properties

Ruft die ExtensionProperties der Standard tenanceConfiguration Support shorthand-syntax, json-file und yaml-file ab oder legt diese fest. Probieren Sie "??" aus, um mehr anzuzeigen.

--install-patches-linux-parameters --linux-parameters

Eingabeparameter, die für das Patchen eines Linux-Computers spezifisch sind. Übergeben Sie diese Eigenschaft für Windows-Computer nicht. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--install-patches-windows-parameters --windows-parameters

Eingabeparameter, die für das Patchen eines Windows-Computers spezifisch sind. Übergeben Sie diese Eigenschaft für Linux-Computer nicht. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--location -l

Ruft den Speicherort der Ressource ab oder legt sie fest.

--maintenance-scope

Ruft Standard tenanceScope der Konfiguration ab oder legt diese fest.

Zulässige Werte: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Rate, mit der ein Wartungsfenster wiederholt werden soll. Die Rate kann als täglicher, wöchentlicher oder monatlicher Zeitplan ausgedrückt werden. Ein täglicher Zeitplan wird als „recurEvery: [Rate als Ganzzahl]['Day(s)']“ formatiert. Wird keine Rate angegeben, wird die Standardrate 1 verwendet. Beispiele für tägliche Zeitpläne sind recurEvery: Day, recurEvery: 3Days. Ein wöchentlicher Zeitplan wird als „recurEvery: [Rate als Ganzzahl]['Week(s)'] [Optionale kommagetrennte Liste der Wochentage Monday-Sunday]“ formatiert. Wöchentliche Zeitplanbeispiele sind recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Monatliche Zeitpläne werden als [Häufigkeit als ganze Zahl]['Monat(n)' [Durch Trennzeichen getrennte Liste der Monatstage] oder [Häufigkeit als ganze Zahl][Monatsmonat(s)] [Woche des Monats (Erste, Zweite, Dritte, Vierte, Letzte)] [Wochentag Montag-Sonntag] [Optional offset(No. of days)] formatiert. Der Offsetwert muss zwischen -6 und einschließlich 6 liegen. Beispiele für monatlichen Zeitplan sind recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Montag, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6.

--maintenance-window-start-date-time --start-date-time

Effektives Startdatum des Wartungsfensters im JJJJ-MM-TT hh:mm-Format. Das Startdatum kann entweder auf das aktuelle Datum oder ein zukünftiges Datum festgelegt werden. Das Fenster wird in der angegebenen Zeitzone erstellt und an die entsprechende Sommerzeit dieser Zeitzone angepasst.

--maintenance-window-time-zone --time-zone

Name der Zeitzone. Die Liste der Zeitzonen kann durch Ausführen von „[System.TimeZoneInfo]::GetSystemTimeZones()“ in PowerShell abgerufen werden. Beispiel: Pacific Normalzeit, UTC, Mitteleuropäische Zeit, Koreanische Normalzeit, Zentralaustralische Normalzeit.

--namespace

Ruft den Namespace der Ressource ab oder legt den Namespace fest.

--reboot-setting

Mögliche Neustarteinstellung gemäß definition des Benutzers, auf deren Grundlage es beschlossen würde, den Computer neu zu starten oder nicht, nachdem der Patchvorgang abgeschlossen wurde.

Zulässige Werte: Always, IfRequired, Never
--tags

Dient zum Abrufen oder Festlegen von Tags der Ressourcenunterstützung kurzhand-Syntax, json-file und yaml-file. Probieren Sie "??" aus, um mehr anzuzeigen.

--visibility

Sichtbarkeit der Konfiguration abrufen oder festlegen. Der Standardwert ist "Benutzerdefiniert".

Zulässige Werte: Custom, Public
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 maintenance configuration delete

Konfigurationsdatensatz löschen.

az maintenance configuration delete [--ids]
                                    [--name]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

Beispiele

MaintenanceConfigurations_DeleteForResource

az maintenance configuration delete --resource-group "examplerg" --resource-name "example1"

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 „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--name --resource-name -n

Name der Wartungskonfiguration.

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

--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 maintenance configuration list

Auflisten von Konfigurationsdatensätzen innerhalb einer Abonnement- und Ressourcengruppe.

az maintenance configuration list [--resource-group]

Beispiele

MaintenanceConfigurations_List

az maintenance configuration list

Optionale Parameter

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

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 maintenance configuration show

Abrufen des Konfigurationsdatensatzes.

az maintenance configuration show [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

Beispiele

MaintenanceConfigurations_GetForResource

az maintenance configuration show --resource-group "examplerg" --resource-name "configuration1"

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 „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--name --resource-name -n

Name der Wartungskonfiguration.

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

az maintenance configuration update

Aktualisieren des Konfigurationsdatensatzes.

az maintenance configuration update [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--ids]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance}]
                                    [--maintenance-window-recur-every]
                                    [--maintenance-window-start-date-time]
                                    [--maintenance-window-time-zone]
                                    [--name]
                                    [--namespace]
                                    [--reboot-setting {Always, IfRequired, Never}]
                                    [--resource-group]
                                    [--subscription]
                                    [--tags]
                                    [--visibility {Custom, Public}]

Beispiele

MaintenanceConfigurations_UpdateForResource

az maintenance configuration update --location "westus2" --maintenance-scope "OSImage" --maintenance-window-duration "05:00" --maintenance-window-expiration-date-time "9999-12-31 00:00" --maintenance-window-recur-every "Month Third Sunday" --maintenance-window-start-date-time "2020-04-30 08:00" --maintenance-window-time-zone "Pacific Standard Time" --namespace "Microsoft.Maintenance" --visibility "Custom" --resource-group "examplerg" --resource-name "configuration1"

Optionale Parameter

--duration --maintenance-window-duration

Dauer des Wartungsfensters im hh:mm-Format. Wenn nicht angegeben, wird der Standardwert basierend auf dem bereitgestellten Wartungsbereich verwendet. z. B. 05:00.

--expiration-date-time --maintenance-window-expiration-date-time

Effektives Ablaufdatum des Wartungsfensters im JJJJ-MM-TT hh:mm-Format. Das Fenster wird in der angegebenen Zeitzone erstellt und an die entsprechende Sommerzeit dieser Zeitzone angepasst. Das Ablaufdatum muss auf ein Datum in der Zukunft festgelegt werden. Ohne Angabe wird es auf den maximalen Zeitpunkt (9999-12-31 23:59:59) festgelegt.

--extension-properties

Ruft die ExtensionProperties der Standard tenanceConfiguration Support shorthand-syntax, json-file und yaml-file ab oder legt diese fest. Probieren Sie "??" aus, um mehr anzuzeigen.

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der „Ressource id“-Argumente handeln. Sie sollten entweder „--ids“ oder andere „Resource Id“-Argumente angeben.

--install-patches-linux-parameters --linux-parameters

Eingabeparameter, die für das Patchen eines Linux-Computers spezifisch sind. Übergeben Sie diese Eigenschaft für Windows-Computer nicht. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--install-patches-windows-parameters --windows-parameters

Eingabeparameter, die für das Patchen eines Windows-Computers spezifisch sind. Übergeben Sie diese Eigenschaft für Linux-Computer nicht. Unterstützung von Shorthand-Syntax, JSON-Datei und Yaml-Datei. Probieren Sie "??" aus, um mehr anzuzeigen.

--location -l

Ruft den Speicherort der Ressource ab oder legt sie fest.

--maintenance-scope

Ruft Standard tenanceScope der Konfiguration ab oder legt diese fest.

Zulässige Werte: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Rate, mit der ein Wartungsfenster wiederholt werden soll. Die Rate kann als täglicher, wöchentlicher oder monatlicher Zeitplan ausgedrückt werden. Ein täglicher Zeitplan wird als „recurEvery: [Rate als Ganzzahl]['Day(s)']“ formatiert. Wird keine Rate angegeben, wird die Standardrate 1 verwendet. Beispiele für tägliche Zeitpläne sind recurEvery: Day, recurEvery: 3Days. Ein wöchentlicher Zeitplan wird als „recurEvery: [Rate als Ganzzahl]['Week(s)'] [Optionale kommagetrennte Liste der Wochentage Monday-Sunday]“ formatiert. Wöchentliche Zeitplanbeispiele sind recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Monatliche Zeitpläne werden als [Häufigkeit als ganze Zahl]['Monat(n)' [Durch Trennzeichen getrennte Liste der Monatstage] oder [Häufigkeit als ganze Zahl][Monatsmonat(s)] [Woche des Monats (Erste, Zweite, Dritte, Vierte, Letzte)] [Wochentag Montag-Sonntag] [Optional offset(No. of days)] formatiert. Der Offsetwert muss zwischen -6 und einschließlich 6 liegen. Beispiele für monatlichen Zeitplan sind recurEvery: Month, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Montag, recurEvery: Month Last Sunday Offset-3, recurEvery: Month Third Sunday Offset6.

--maintenance-window-start-date-time --start-date-time

Effektives Startdatum des Wartungsfensters im JJJJ-MM-TT hh:mm-Format. Das Startdatum kann entweder auf das aktuelle Datum oder ein zukünftiges Datum festgelegt werden. Das Fenster wird in der angegebenen Zeitzone erstellt und an die entsprechende Sommerzeit dieser Zeitzone angepasst.

--maintenance-window-time-zone --time-zone

Name der Zeitzone. Die Liste der Zeitzonen kann durch Ausführen von „[System.TimeZoneInfo]::GetSystemTimeZones()“ in PowerShell abgerufen werden. Beispiel: Pacific Normalzeit, UTC, Mitteleuropäische Zeit, Koreanische Normalzeit, Zentralaustralische Normalzeit.

--name --resource-name -n

Name der Wartungskonfiguration.

--namespace

Ruft den Namespace der Ressource ab oder legt den Namespace fest.

--reboot-setting

Mögliche Neustarteinstellung gemäß definition des Benutzers, auf deren Grundlage es beschlossen würde, den Computer neu zu starten oder nicht, nachdem der Patchvorgang abgeschlossen wurde.

Zulässige Werte: Always, IfRequired, Never
--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.

--tags

Dient zum Abrufen oder Festlegen von Tags der Ressourcenunterstützung kurzhand-Syntax, json-file und yaml-file. Probieren Sie "??" aus, um mehr anzuzeigen.

--visibility

Sichtbarkeit der Konfiguration abrufen oder festlegen. Der Standardwert ist "Benutzerdefiniert".

Zulässige Werte: Custom, Public
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.