Freigeben über

az maintenance configuration

  • Referenz

Anmerkung

Diese Referenz ist Teil der Wartung Erweiterung für die Azure CLI (Version 2.67.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie zum ersten Mal eine Az-Wartungskonfiguration Befehl ausführen. Erfahren Sie mehr über Erweiterungen.

Verwalten Sie die Wartungskonfiguration mit Wartung.

Befehle

Name Beschreibung Typ Status
az maintenance configuration create

Erstellen Sie einen Konfigurationsdatensatz.

 Erweiterung GA
az maintenance configuration delete

Konfigurationsdatensatz löschen.

 Erweiterung GA
az maintenance configuration list

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

 Erweiterung GA
az maintenance configuration show

Abrufen des Konfigurationsdatensatzes.

 Erweiterung GA
az maintenance configuration update

Aktualisieren des Konfigurationsdatensatzes.

 Erweiterung GA

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 Wartungsumfang verwendet. Beispiel: 05:00.

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

Effektives Ablaufdatum des Wartungsfensters im JJJJ-MM-DD hh:mm-Format. Das Fenster wird in der bereitgestellten Zeitzone erstellt und entsprechend dieser Zeitzone auf Sommereinsparungen angepasst. Das Ablaufdatum muss auf ein zukünftiges Datum festgelegt werden. Wenn nicht angegeben, wird sie auf die maximale Datumszeit 9999-12-31 23:59:59:59 festgelegt.

--extension-properties

Ruft die extensionProperties der maintenanceConfiguration 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

Dient zum Abrufen oder Festlegen von MaintenanceScope der Konfiguration.

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

Rate, mit der ein Wartungsfenster wieder auftritt. Der Satz kann als tägliche, wöchentliche oder monatliche Zeitpläne ausgedrückt werden. Tageszeitplan wird als "recurEvery" formatiert: [Häufigkeit als ganze Zahl]['Tag(n)']. Wenn keine Häufigkeit angegeben wird, ist die Standardhäufigkeit 1. Beispiele für tägliche Zeitpläne sind recurEvery: Day, recurEvery: 3Days. Wochenplan wird als "recurEvery" formatiert: [Häufigkeit als ganze Zahl]['Woche(n)'] [Optionale durch Komma getrennte Liste der Wochentage Montag-Sonntag]. 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-DD hh:mm-Format. Das Startdatum kann entweder auf das aktuelle Datum oder das zukünftige Datum festgelegt werden. Das Fenster wird in der bereitgestellten Zeitzone erstellt und entsprechend dieser Zeitzone auf Sommereinsparungen angepasst.

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

Name der Zeitzone. Eine Liste der Zeitzonen kann durch Ausführen von [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell abgerufen werden. Beispiel: Pacific Standard Time, UTC, W. Europe Standard Time, Korea Standard Time, Cen. Australien Standardzeit.

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

Ruft die Sichtbarkeit der Konfiguration ab oder legt sie fest. Der Standardwert ist "Benutzerdefiniert".

Zulässige Werte: Custom, Public
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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

Mindestens eine 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 --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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--yes -y

Zur Bestätigung nicht auffordern.

Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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

Mindestens eine 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 --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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

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 Wartungsumfang verwendet. Beispiel: 05:00.

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

Effektives Ablaufdatum des Wartungsfensters im JJJJ-MM-DD hh:mm-Format. Das Fenster wird in der bereitgestellten Zeitzone erstellt und entsprechend dieser Zeitzone auf Sommereinsparungen angepasst. Das Ablaufdatum muss auf ein zukünftiges Datum festgelegt werden. Wenn nicht angegeben, wird sie auf die maximale Datumszeit 9999-12-31 23:59:59:59 festgelegt.

--extension-properties

Ruft die extensionProperties der maintenanceConfiguration Support shorthand-Syntax, json-file und yaml-file ab oder legt diese fest. Probieren Sie "??" aus, um mehr anzuzeigen.

--ids

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

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

Dient zum Abrufen oder Festlegen von MaintenanceScope der Konfiguration.

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

Rate, mit der ein Wartungsfenster wieder auftritt. Der Satz kann als tägliche, wöchentliche oder monatliche Zeitpläne ausgedrückt werden. Tageszeitplan wird als "recurEvery" formatiert: [Häufigkeit als ganze Zahl]['Tag(n)']. Wenn keine Häufigkeit angegeben wird, ist die Standardhäufigkeit 1. Beispiele für tägliche Zeitpläne sind recurEvery: Day, recurEvery: 3Days. Wochenplan wird als "recurEvery" formatiert: [Häufigkeit als ganze Zahl]['Woche(n)'] [Optionale durch Komma getrennte Liste der Wochentage Montag-Sonntag]. 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-DD hh:mm-Format. Das Startdatum kann entweder auf das aktuelle Datum oder das zukünftige Datum festgelegt werden. Das Fenster wird in der bereitgestellten Zeitzone erstellt und entsprechend dieser Zeitzone auf Sommereinsparungen angepasst.

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

Name der Zeitzone. Eine Liste der Zeitzonen kann durch Ausführen von [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell abgerufen werden. Beispiel: Pacific Standard Time, UTC, W. Europe Standard Time, Korea Standard Time, Cen. Australien Standardzeit.

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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

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

Ruft die Sichtbarkeit der Konfiguration ab oder legt sie fest. Der Standardwert ist "Benutzerdefiniert".

Zulässige Werte: Custom, Public
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, 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

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.