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
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Ressourcenbezeichner.
Optionale Parameter
Dauer des Wartungsfensters im hh:mm-Format. Ohne Angabe wird der Standardwert basierend auf dem angegebenen Wartungsbereich verwendet, Beispiel: 05:00.
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.
Dient zum Abrufen oder Festlegen von ExtensionProperties des MaintenanceConfiguration Expect-Werts: KEY1=VALUE1 KEY2=VALUE2 ...
Eingabeparameter, die für das Patchen des Linux-Computers spezifisch sind. Für Windows-Computer übergeben Sie diese Eigenschaft nicht.
Liste der Postaufgaben. z. B. [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] Erwarteter Wert: json-string/json-file/@json-file.
Liste der Voraufgaben. z. B. [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}] Erwarteter Wert: json-string/json-file/@json-file.
Eingabeparameter, die für das Patchen eines Windows-Computers spezifisch sind. Für Linux-Computer übergeben Sie diese Eigenschaft nicht.
Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.
Dient zum Abrufen oder Festlegen von MaintenanceScope der Konfiguration.
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.
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.
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.
Ruft den Namespace der Ressource ab oder legt sie fest.
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.
Leerzeichentrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Ruft die Sichtbarkeit der Konfiguration ab bzw. legt diese fest.
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Ressourcenbezeichner.
Optionale Parameter
Nicht zur Bestätigung auffordern
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az maintenance configuration list
Abrufen von Konfigurationsdatensätzen innerhalb eines Abonnements.
az maintenance configuration list
Beispiele
MaintenanceConfigurations_List
az maintenance configuration list
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Ressourcenbezeichner.
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
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
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Ressourcenbezeichner.
Optionale Parameter
Dauer des Wartungsfensters im hh:mm-Format. Ohne Angabe wird der Standardwert basierend auf dem angegebenen Wartungsbereich verwendet, Beispiel: 05:00.
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.
Dient zum Abrufen oder Festlegen von ExtensionProperties des MaintenanceConfiguration Expect-Werts: KEY1=VALUE1 KEY2=VALUE2 ...
Eingabeparameter, die für das Patchen des Linux-Computers spezifisch sind. Für Windows-Computer übergeben Sie diese Eigenschaft nicht.
Liste der Postaufgaben. z. B. [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] Erwarteter Wert: json-string/json-file/@json-file.
Liste der Voraufgaben. z. B. [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}} Erwarteter Wert: json-string/json-file/@json-file/@json-file.
Eingabeparameter, die für das Patchen eines Windows-Computers spezifisch sind. Für Linux-Computer übergeben Sie diese Eigenschaft nicht.
Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.
Ruft das MaintenanceScope der Konfiguration ab oder legt sie fest.
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.
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.
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.
Ruft den Namespace der Ressource ab oder legt sie fest.
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.
Leergetrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.
Ruft die Sichtbarkeit der Konfiguration ab bzw. legt diese fest.
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
Feedback
Feedback senden und anzeigen für