az aks maintenancewindow

Note

Deze verwijzing maakt deel uit van de aks-preview-extensie voor de Azure CLI (versie 2.85.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az aks maintenancewindow-opdracht uitvoert. Meer informatie over uitbreidingen.

Opdrachten voor het beheren van MaintenanceWindow-peer-ARM-resources.

MaintenanceWindow is een ARM-resource binnen het bereik van een resourcegroep die een herbruikbaar onderhoudsschema definieert. Gebruikers kunnen deze resource koppelen aan een bestaande maintenanceConfiguration via maintenanceWindowId, zodat meerdere beheerdeclusteronderhoudsconfiguraties één MaintenanceWindow delen en de planning op één plaats aanwezig is.

Vereist de Microsoft. ContainerService/AKSSharedMaintenanceWindowPreview-functie die moet worden geregistreerd voor het abonnement. Automatische goedkeuring is ingeschakeld: az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

Opdracht

Naam	Description	Type	Status
az aks maintenancewindow create	Maak een MaintenanceWindow.	Extension	GA
az aks maintenancewindow delete	Een MaintenanceWindow verwijderen.	Extension	GA
az aks maintenancewindow list	Vermeld MaintenanceWindows in een resourcegroep of in het abonnement als --resource-group wordt weggelaten.	Extension	GA
az aks maintenancewindow show	Een MaintenanceWindow weergeven.	Extension	GA
az aks maintenancewindow update	Een MaintenanceWindow bijwerken.	Extension	GA
az aks maintenancewindow wait	Wacht tot een MaintenanceWindow de gewenste status heeft bereikt.	Extension	GA

az aks maintenancewindow create

Maak een MaintenanceWindow.

Vereist de Microsoft. ContainerService/AKSSharedMaintenanceWindowPreview-functie die moet worden geregistreerd voor het abonnement. Eenmaal registreren (automatisch goedgekeurd): az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

az aks maintenancewindow create --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--config-file]
                                [--day-of-month]
                                [--day-of-week]
                                [--duration]
                                [--interval-days]
                                [--interval-months]
                                [--interval-weeks]
                                [--location]
                                [--no-wait]
                                [--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
                                [--start-date]
                                [--start-time]
                                [--tags]
                                [--utc-offset]
                                [--week-index {First, Fourth, Last, Second, Third}]

Voorbeelden

Maak een wekelijks zaterdagvenster (de canonieke vorm 'productieweekends').

az aks maintenancewindow create -g rg-maintenance -n production-weekends -l eastus \
  --schedule-type Weekly --day-of-week Saturday --interval-weeks 1 \
  --start-time "02:00" --duration 8 --utc-offset=-07:00 \
  --tags environment=production

Maak elke 2 dagen een dagelijks venster vanaf een specifieke begindatum.

az aks maintenancewindow create -g rg-maintenance -n nightly -l eastus \
  --schedule-type Daily --interval-days 2 \
  --start-date 2026-06-01 --start-time "00:00" --duration 6 --utc-offset=-08:00

Maak een absoluut maandelijks venster op de 15e.

az aks maintenancewindow create -g rg-maintenance -n monthly-15 -l eastus \
  --schedule-type AbsoluteMonthly --day-of-month 15 --interval-months 1 \
  --start-time "09:30" --duration 6 --utc-offset=+05:30

Maak een relatief maandelijks venster op de afgelopen vrijdag.

az aks maintenancewindow create -g rg-maintenance -n last-friday -l eastus \
  --schedule-type RelativeMonthly --day-of-week Friday --week-index Last --interval-months 1 \
  --start-time "01:00" --duration 4 --utc-offset=+00:00

Maak een wekelijks venster met black-outdatums via een configuratiebestand.

az aks maintenancewindow create -g rg-maintenance -n weekly-with-holidays -l eastus \
  --config-file ./mw-body.json
  The contents of mw-body.json:
  {
    "properties": {
      "schedule": { "weekly": { "intervalWeeks": 1, "dayOfWeek": "Saturday" } },
      "startTime": "02:00",
      "durationHours": 8,
      "utcOffset": "-07:00",
      "notAllowedDates": [
        { "start": "2026-12-23", "end": "2027-01-05" },
        { "start": "2026-07-04", "end": "2026-07-05" }
      ]
    }
  }

Vereiste parameters

--name -n

De naam van het onderhoudsvenster.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap	Waarde
Parametergroep:	Global Policy Arguments

--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap	Waarde
Parametergroep:	Global Policy Arguments

--config-file

Pad naar een JSON-bestand met een beschrijving van de hoofdtekst MaintenanceWindow. Gebruik deze optie wanneer u velden wilt instellen zonder toegewezen vlaggen (bijvoorbeeld nietAllowedDates/blackout-datumbereiken).

--day-of-month

Dag van de maand vindt het onderhoud plaats. bijvoorbeeld 15. AbsoluteMonthly-planning alleen.

--day-of-week

Dag van de week vindt het onderhoud plaats. bijvoorbeeld maandag. Alleen wekelijkse of RelatieveMonthly-schema's.

--duration

De lengte van het onderhoudsvenster in uren. Bereik 4-24.

--interval-days

Aantal dagen tussen exemplaren. Alleen dagelijkse planning.

--interval-months

Aantal maanden tussen exemplaren. AbsoluteMonthly- of RelativeMonthly-schema's alleen.

--interval-weeks

Aantal weken tussen voorvallen. Alleen wekelijks schema.

--location -l

Locatie voor maintenancewindow. De standaardinstelling is de locatie van de resourcegroep wanneer deze wordt weggelaten.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Default value:	False

--schedule-type

Type herhaling. Een van dagelijks, wekelijks, AbsoluteMonthly of RelativeMonthly.

Eigenschap	Waarde
Geaccepteerde waarden:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

De datum waarop het onderhoudsvenster wordt geactiveerd. bijvoorbeeld 2026-06-01. Als dit niet is opgegeven, wordt het venster onmiddellijk geactiveerd.

--start-time

De begintijd van het onderhoudsvenster. Geaccepteerde waarden zijn van '00:00' tot '23:59'. --utc-offset is van toepassing op dit veld.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--utc-offset

De UTC-offset in notatie +/-UU:mm. Bijvoorbeeld '+05:30' voor IST of '-07:00' voor PST. De standaardwaarde is +00:00.

--week-index

Instantie van de dag van de week vindt het onderhoud plaats (eerste, tweede, derde, vierde, laatste). Alleen relativeMonthly-schema.

Eigenschap	Waarde
Geaccepteerde waarden:	First, Fourth, Last, Second, Third

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az aks maintenancewindow delete

Een MaintenanceWindow verwijderen.

az aks maintenancewindow delete --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--no-wait]
                                [--yes]

Vereiste parameters

--name -n

De naam van het onderhoudsvenster.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap	Waarde
Parametergroep:	Global Policy Arguments

--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap	Waarde
Parametergroep:	Global Policy Arguments

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Default value:	False

--yes -y

Niet vragen om bevestiging.

Eigenschap	Waarde
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az aks maintenancewindow list

Vermeld MaintenanceWindows in een resourcegroep of in het abonnement als --resource-group wordt weggelaten.

az aks maintenancewindow list [--resource-group]

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az aks maintenancewindow show

Een MaintenanceWindow weergeven.

az aks maintenancewindow show --name
                              --resource-group

Vereiste parameters

--name -n

De naam van het onderhoudsvenster.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az aks maintenancewindow update

Een MaintenanceWindow bijwerken.

Semantiek az aks updateaz aks nodepool updatevoor lezen en wijzigen en: de bestaande MW wordt opgehaald, de opgegeven velden worden samengevoegd en de resulterende hoofdtekst is TERUG. Velden die u niet opgeeft, blijven behouden as-is (bestaande tags, bestaande schema scalaire schema's, bestaande black-outdatums, enzovoort).

Wanneer u een plannings arg opgeeft (--schedule-type / --interval-* / --day-of-week / --day-of-month-index), wordt de planningshape opnieuw gebouwd vanaf uw args (u kunt niet gedeeltelijk dagelijks + wekelijkse velden combineren— kies één planningstype en geef de vereiste args op).

--tags volgt aks update de conventie: het doorgeven van --tags vervangt de hele woordenlijst met tags; laat --tags weg om de bestaande tags te behouden.

--location kan niet worden gewijzigd (TrackedResource-semantiek : ARM weigert locatiewijzigingen op PUT). Als deze wordt opgegeven met een andere waarde dan de bestaande locatie, wordt deze genegeerd met een waarschuwing.

--config-file: wanneer het JSON-bestand wordt opgegeven, vervangt het blok van het JSON-bestand properties de bestaande properties groothandel. Dit is de enige manier om vandaag notAllowedDates / blackout datumbereiken te muteren. Afzonderlijke planningsvlagmen worden genegeerd op dit pad; tags volgen dezelfde --tags regel als zonder --config-file.

az aks maintenancewindow update --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--config-file]
                                [--day-of-month]
                                [--day-of-week]
                                [--duration]
                                [--interval-days]
                                [--interval-months]
                                [--interval-weeks]
                                [--location]
                                [--no-wait]
                                [--schedule-type {AbsoluteMonthly, Daily, RelativeMonthly, Weekly}]
                                [--start-date]
                                [--start-time]
                                [--tags]
                                [--utc-offset]
                                [--week-index {First, Fourth, Last, Second, Third}]

Voorbeelden

Alleen tags bijwerken (bestaande planning blijft behouden).

az aks maintenancewindow update -g rg-maintenance -n production-weekends --tags environment=staging

Werk alleen de dag van de week van de planning bij (bestaande duur/begintijd/tags behouden).

az aks maintenancewindow update -g rg-maintenance -n production-weekends \
  --schedule-type Weekly --day-of-week Sunday --interval-weeks 1

Alleen de duur wijzigen (bestaande planningsshape behouden).

az aks maintenancewindow update -g rg-maintenance -n production-weekends --duration 6

Vervang black-outdatums via een configuratiebestand (behoudt tags, locatie).

az aks maintenancewindow update -g rg-maintenance -n production-weekends --config-file ./mw-body.json
  The contents of mw-body.json should include a complete properties block, e.g.:
  {
    "properties": {
      "schedule": { "weekly": { "intervalWeeks": 1, "dayOfWeek": "Saturday" } },
      "startTime": "02:00",
      "durationHours": 8,
      "utcOffset": "-07:00",
      "notAllowedDates": [ { "start": "2026-12-23", "end": "2027-01-05" } ]
    }
  }

Vereiste parameters

--name -n

De naam van het onderhoudsvenster.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap	Waarde
Parametergroep:	Global Policy Arguments

--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap	Waarde
Parametergroep:	Global Policy Arguments

--config-file

Pad naar een JSON-bestand met een beschrijving van de hoofdtekst MaintenanceWindow. Wanneer deze is opgegeven, definieert de JSON de resource bij het maken of vervangt het bestaande properties blok bij de update. Dit is het enige pad dat velden kan instellen zonder toegewezen vlaggen (notAllowedDates, enzovoort).

--day-of-month

Dag van de maand vindt het onderhoud plaats voor AbsoluteMonthly-planning.

--day-of-week

Dag van de week vindt het onderhoud plaats voor het wekelijkse of relatieve maandschema.

--duration

De lengte van het onderhoudsvenster in uren. Bereik 4-24.

--interval-days

Het aantal dagen tussen elke set exemplaren voor de dagelijkse planning.

--interval-months

Het aantal maanden tussen elke set exemplaren voor het schema AbsoluteMonthly of RelativeMonthly.

--interval-weeks

Het aantal weken tussen elke set exemplaren voor wekelijkse planning.

--location -l

Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--no-wait

Wacht niet totdat de langdurige bewerking is voltooid.

Eigenschap	Waarde
Default value:	False

--schedule-type

Terugkeerpatroon: Dagelijks, Wekelijks, AbsoluteMonthly of RelativeMonthly.

Eigenschap	Waarde
Geaccepteerde waarden:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

De datum waarop het onderhoudsvenster wordt geactiveerd. bijvoorbeeld 2026-06-01.

--start-time

De begintijd van het onderhoudsvenster. bijvoorbeeld 09:30 uur.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

--utc-offset

De UTC-offset in notatie +/-UU:mm. bijvoorbeeld -08:00 of +05:30.

--week-index

Exemplaar van de weekdag die is opgegeven in --day-of-week, het onderhoud vindt plaats voor de RelativeMonthly-planning.

Eigenschap	Waarde
Geaccepteerde waarden:	First, Fourth, Last, Second, Third

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

az aks maintenancewindow wait

Wacht tot een MaintenanceWindow de gewenste status heeft bereikt.

Als een bewerking op een MaintenanceWindow is onderbroken of is --no-waitgestart, gebruikt u deze opdracht om te wachten tot deze is voltooid.

az aks maintenancewindow wait --name
                              --resource-group
                              [--acquire-policy-token]
                              [--change-reference]
                              [--created]
                              [--custom]
                              [--deleted]
                              [--exists]
                              [--interval]
                              [--timeout]
                              [--updated]

Voorbeelden

Wacht tot een MaintenanceWindow is gemaakt.

az aks maintenancewindow wait -g rg-maintenance -n production-weekends --created

Vereiste parameters

--name -n

De naam van het onderhoudsvenster.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--acquire-policy-token

Automatisch een Azure Policy token verkrijgen voor deze resourcebewerking.

Eigenschap	Waarde
Parametergroep:	Global Policy Arguments

--change-reference

De gerelateerde wijzigingsverwijzings-id voor deze resourcebewerking.

Eigenschap	Waarde
Parametergroep:	Global Policy Arguments

--created

Wacht totdat u 'provisioningState' hebt gemaakt bij 'Succeeded'.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	False

--custom

Wacht tot de voorwaarde voldoet aan een aangepaste JMESPath-query. Bijvoorbeeld provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments

--deleted

Wacht totdat deze is verwijderd.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	False

--exists

Wacht tot de resource bestaat.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	False

--interval

Polling-interval in seconden.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	30

--timeout

Maximale wachttijd in seconden.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	3600

--updated

Wacht totdat deze is bijgewerkt met provisioningState op 'Succeeded'.

Eigenschap	Waarde
Parametergroep:	Wait Condition Arguments
Default value:	False

Globale parameters

--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap	Waarde
Default value:	False

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap	Waarde
Default value:	False

--output -o

Uitvoerindeling.

Eigenschap	Waarde
Default value:	json
Geaccepteerde waarden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap	Waarde
Default value:	False

Feedback

Is deze pagina nuttig?