az maintenance configuration

Hinweis

Dieser Verweis ist Teil der Wartungserweiterung für die Azure CLI (Version 2.15.0 oder höher). Die Erweiterung wird beim ersten Ausführen eines Az-Wartungskonfigurationsbefehls automatisch installiert. Weitere Informationen zu Erweiterungen

Verwalten der Wartungskonfiguration mit Wartung.

Befehle

az maintenance configuration create

Erstellen Sie den Konfigurationsdatensatz.

az maintenance configuration delete

Konfigurationsdatensatz löschen.

az maintenance configuration list

Abrufen von Konfigurationsdatensätzen innerhalb eines Abonnements.

az maintenance configuration show

Konfigurationsdatensatz abrufen.

az maintenance configuration update

Patchkonfigurationsdatensatz.

az maintenance configuration create

Erstellen Sie den Konfigurationsdatensatz.

az maintenance configuration create --resource-group
                                    --resource-name
                                    [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-post-tasks]
                                    [--install-patches-pre-tasks]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {All, Extension, Host, InGuestPatch, InResource, 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

--resource-group -g

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

--resource-name

Ressourcenbezeichner.

Optionale Parameter

--duration --maintenance-window-duration

Dauer des Wartungsfensters im hh:mm-Format. Ohne Angabe wird der Standardwert basierend auf dem angegebenen Wartungsbereich verwendet, Beispiel: 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 Sommerzeit entsprechend dieser Zeitzone angepasst. Das Ablaufdatum muss auf ein zukünftiges Datum festgelegt werden. Falls nicht angegeben, wird es auf die maximale Datumszeit 9999-12-31 23:59:59 festgelegt.

--extension-properties

Dient zum Abrufen oder Festlegen von ExtensionProperties des MaintenanceConfiguration Expect-Werts: KEY1=VALUE1 KEY2=VALUE2 ...

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

Eingabeparameter, die für das Patchen des Linux-Computers spezifisch sind. Für Windows-Computer übergeben Sie diese Eigenschaft nicht.

--install-patches-post-tasks --post-tasks

Liste der Postaufgaben. z. B. [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] Erwarteter Wert: json-string/json-file/@json-file.

--install-patches-pre-tasks --pre-tasks

Liste der Voraufgaben. z. B. [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}] Erwarteter Wert: json-string/json-file/@json-file.

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

Eingabeparameter, die für das Patchen eines Windows-Computers spezifisch sind. Für Linux-Computer übergeben Sie diese Eigenschaft nicht.

--location -l

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

--maintenance-scope

Dient zum Abrufen oder Festlegen von MaintenanceScope der Konfiguration.

Zulässige Werte: All, Extension, Host, InGuestPatch, InResource, 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. Täglicher Zeitplan wird als recurEvery formatiert: [Häufigkeit als Ganzzahl]['Day(s)']. Wenn keine Häufigkeit bereitgestellt wird, ist die Standardfrequenz 1. Beispiele für tägliche Zeitpläne sind recurEvery: Day, recurEvery: 3Days. Wöchentlicher Zeitplan wird als recurEvery formatiert: [Häufigkeit als Ganzzahl]['Week(s)'] [Optional Komma separate Liste der Wochentage Montag-Sonntag]. Beispiele für wöchentliche Zeitpläne sind recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Monatliche Zeitpläne werden als [Häufigkeit als ganze Zahl]['Monat(n)] [Durch Trennzeichen getrennte Liste von Monatstagen] oder [Häufigkeit als ganze Zahl]['Monat(s)] [Woche des Monats (First, Second, Third, Last)] [Weekday Montag-Sonntag] [Optional Offset(Nein) formatiert. von Tagen)]. Der Offsetwert muss zwischen -6 und 6 einschließlich liegen. Monatliche Zeitplanbeispiele sind recurEvery: Monat, recurEvery: 2Months, recurEvery: Month day23,day24, recurEvery: Month Last Sunday, recurEvery: Month Fourth Monday, 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 das zukünftige Datum festgelegt werden. Das Fenster wird in der angegebenen Zeitzone erstellt und an die Sommerzeit entsprechend 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: Pazifische Standardzeit, UTC, W. Europäische Standardzeit, Korea Standardzeit, Cen. Australische Normalzeit.

--namespace

Ruft den Namespace der Ressource ab oder legt sie fest.

--reboot-setting

Mögliche Neustarteinstellungen gemäß der Definition des Benutzers, auf deren Grundlage beschlossen wird, den Computer neu zu starten oder nicht, nachdem der Patchvorgang abgeschlossen wurde.

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

Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--visibility

Ruft die Sichtbarkeit der Konfiguration ab bzw. legt diese fest.

Zulässige Werte: Custom, Public

az maintenance configuration delete

Konfigurationsdatensatz löschen.

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

Beispiele

MaintenanceConfigurations_DeleteForResource

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

Erforderliche Parameter

--resource-group -g

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

--resource-name

Ressourcenbezeichner.

Optionale Parameter

--yes -y

Nicht zur Bestätigung auffordern

az maintenance configuration list

Abrufen von Konfigurationsdatensätzen innerhalb eines Abonnements.

az maintenance configuration list

Beispiele

MaintenanceConfigurations_List

az maintenance configuration list

az maintenance configuration show

Konfigurationsdatensatz abrufen.

az maintenance configuration show --resource-group
                                  --resource-name

Beispiele

MaintenanceConfigurations_GetForResource

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

MaintenanceConfigurations_GetForResource_GuestOSPatchLinux

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

MaintenanceConfigurations_GetForResource_GuestOSPatchWindows

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

Erforderliche Parameter

--resource-group -g

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

--resource-name

Ressourcenbezeichner.

az maintenance configuration update

Patchkonfigurationsdatensatz.

az maintenance configuration update --resource-group
                                    --resource-name
                                    [--duration]
                                    [--expiration-date-time]
                                    [--extension-properties]
                                    [--install-patches-linux-parameters]
                                    [--install-patches-post-tasks]
                                    [--install-patches-pre-tasks]
                                    [--install-patches-windows-parameters]
                                    [--location]
                                    [--maintenance-scope {All, Extension, Host, InGuestPatch, InResource, 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_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"

Erforderliche Parameter

--resource-group -g

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

--resource-name

Ressourcenbezeichner.

Optionale Parameter

--duration --maintenance-window-duration

Dauer des Wartungsfensters im hh:mm-Format. Ohne Angabe wird der Standardwert basierend auf dem angegebenen Wartungsbereich verwendet, Beispiel: 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 Sommerzeit entsprechend dieser Zeitzone angepasst. Das Ablaufdatum muss auf ein zukünftiges Datum festgelegt werden. Falls nicht angegeben, wird es auf die maximale Datumszeit 9999-12-31 23:59:59 festgelegt.

--extension-properties

Dient zum Abrufen oder Festlegen von ExtensionProperties des MaintenanceConfiguration Expect-Werts: KEY1=VALUE1 KEY2=VALUE2 ...

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

Eingabeparameter, die für das Patchen des Linux-Computers spezifisch sind. Für Windows-Computer übergeben Sie diese Eigenschaft nicht.

--install-patches-post-tasks --post-tasks

Liste der Postaufgaben. z. B. [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] Erwarteter Wert: json-string/json-file/@json-file.

--install-patches-pre-tasks --pre-tasks

Liste der Voraufgaben. z. B. [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}} Erwarteter Wert: json-string/json-file/@json-file/@json-file.

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

Eingabeparameter, die für das Patchen eines Windows-Computers spezifisch sind. Für Linux-Computer übergeben Sie diese Eigenschaft nicht.

--location -l

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

--maintenance-scope

Ruft das MaintenanceScope der Konfiguration ab oder legt sie fest.

Zulässige Werte: All, Extension, Host, InGuestPatch, InResource, 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. Täglicher Zeitplan wird als recurEvery formatiert: [Häufigkeit als Ganzzahl]['Day(s)']. Wenn keine Häufigkeit bereitgestellt wird, ist die Standardfrequenz 1. Beispiele für tägliche Zeitpläne sind recurEvery: Day, recurEvery: 3Days. Wöchentlicher Zeitplan wird als recurEvery formatiert: [Häufigkeit als Ganzzahl]['Week(s)'] [Optional Komma separate Liste der Wochentage Montag-Sonntag]. Beispiele für wöchentliche Zeitpläne sind recurEvery: 3Weeks, recurEvery: Week Saturday,Sunday. Monatliche Zeitplan werden als [Häufigkeit als ganze Zahl]['Monat(s)] [Getrennte Liste von Monatstagen] oder [Häufigkeit als ganze Zahl]['Monat(s)] [Woche des Monats (First, Second, Third, Last)] [Weekday Montag-Sonntag] [Optional Offset(Nein) formatiert. tage)] Der Offsetwert muss zwischen -6 und 6 inklusive sein. Monatliche Zeitplanbeispiele sind recurEvery: Monat, recurEvery: 2Months, recurEvery: Monat Tag23,Tag24, recurEvery: Monat Last Sonntag, recurEvery: Monat Vierter Montag, recurEvery: Monat 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 das zukünftige Datum festgelegt werden. Das Fenster wird in der angegebenen Zeitzone erstellt und an die Sommerzeit entsprechend 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: Pazifische Standardzeit, UTC, W. Europäische Standardzeit, Korea Standardzeit, Cen. Australische Normalzeit.

--namespace

Ruft den Namespace der Ressource ab oder legt sie fest.

--reboot-setting

Mögliche Neustarteinstellung gemäß der 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

Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--visibility

Ruft die Sichtbarkeit der Konfiguration ab bzw. legt diese fest.

Zulässige Werte: Custom, Public