az aks maintenancewindow

Note

Den här referensen är en del av aks-preview-tillägget för Azure CLI (version 2.85.0 eller senare). Tillägget installeras automatiskt första gången du kör kommandot az aks maintenancewindow . Läs mer om tillägg.

Kommandon för att hantera UnderhållWindow peer ARM-resurser.

MaintenanceWindow är en ARM-resurs med resursgruppsomfång som definierar ett underhållsschema som kan återanvändas. Användare kan länka den här resursen till ett befintligt underhållKonfiguration via maintenanceWindowId, så att flera managedCluster-underhållskonfigurationer delar ett enda UnderhållWindow och schemat finns på ett och samma ställe.

Kräver Microsoft. ContainerService/AKSSharedMaintenanceWindowPreview-funktionen som ska registreras i prenumerationen. Automatiskt godkännande är aktiverat: az feature register --namespace Microsoft.ContainerService --name AKSSharedMaintenanceWindowPreview.

Kommandon

Name	Description	Typ	Status
az aks maintenancewindow create	Skapa ett underhållWindow.	Extension	GA
az aks maintenancewindow delete	Ta bort ett underhållWindow.	Extension	GA
az aks maintenancewindow list	Lista UnderhållWindows i en resursgrupp eller i hela prenumerationen om --resource-group utelämnas.	Extension	GA
az aks maintenancewindow show	Visa ett underhållWindow.	Extension	GA
az aks maintenancewindow update	Uppdatera ett underhållWindow.	Extension	GA
az aks maintenancewindow wait	Vänta tills ett UnderhållWindow har nått önskat tillstånd.	Extension	GA

az aks maintenancewindow create

Skapa ett underhållWindow.

Kräver Microsoft. ContainerService/AKSSharedMaintenanceWindowPreview-funktionen som ska registreras i prenumerationen. Registrera en gång (automatiskt godkänd): 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}]

Exempel

Skapa ett veckovis lördagsfönster (den kanoniska formen "produktionshelger").

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

Skapa ett dagligt fönster var 2:e dag från ett visst startdatum.

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

Skapa ett absolut månadsfönster den 15:e.

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

Skapa ett relativt månatligt fönster den senaste fredagen.

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

Skapa ett veckofönster med blackout-datum via en konfigurationsfil.

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" }
      ]
    }
  }

Obligatoriska parametrar

--name -n

Namn på underhållsperiod.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--config-file

Sökväg till en JSON-fil som beskriver MaintenanceWindow-brödtexten. Använd när du behöver ange fält utan dedikerade flaggor (t.ex. notAllowedDates/blackout date ranges).

--day-of-month

Dag i månaden inträffar underhållet. t.ex. 15. AbsoluteMonthly schema endast.

--day-of-week

Dag i veckan inträffar underhållet. t.ex. måndag. Scheman för veckovisa eller relativamånader.

--duration

Längden på underhållsfönstret i timmar. Intervall 4-24.

--interval-days

Antal dagar mellan förekomster. Endast dagligt schema.

--interval-months

Antal månader mellan förekomster. AbsoluteMonthly eller RelativeMonthly schemalägger endast.

--interval-weeks

Antal veckor mellan förekomster. Endast veckoschema.

--location -l

Plats för MaintenanceWindow. Standardvärdet är resursgruppens plats när den utelämnas.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Egenskap	Värde
Standardvärde:	False

--schedule-type

Typ av upprepning. En av Daily, Weekly, AbsoluteMonthly eller RelativeMonthly.

Egenskap	Värde
Godkända värden:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

Det datum då underhållsfönstret aktiveras. 2026-06-01. Om det inte anges aktiveras fönstret omedelbart.

--start-time

Starttiden för underhållsperioden. Godkända värden är från 00:00 till 23:59. --utc-offset gäller för det här fältet.

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

--utc-offset

UTC-förskjutningen i formatet +/-HH:mm. Till exempel +05:30 för IST eller -07:00 för PST. Standardvärdet är +00:00.

--week-index

Instans av veckodagen sker underhållet (första, andra, tredje, fjärde, sista). RelativeMonthly schemalägger endast.

Egenskap	Värde
Godkända värden:	First, Fourth, Last, Second, Third

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az aks maintenancewindow delete

Ta bort ett underhållWindow.

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

Obligatoriska parametrar

--name -n

Namn på underhållsperiod.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Egenskap	Värde
Standardvärde:	False

--yes -y

Fråga inte efter bekräftelse.

Egenskap	Värde
Standardvärde:	False

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az aks maintenancewindow list

Lista UnderhållWindows i en resursgrupp eller i hela prenumerationen om --resource-group utelämnas.

az aks maintenancewindow list [--resource-group]

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az aks maintenancewindow show

Visa ett underhållWindow.

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

Obligatoriska parametrar

--name -n

Namn på underhållsperiod.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az aks maintenancewindow update

Uppdatera ett underhållWindow.

Matchning az aks update av läs-ändra-skriv-semantik och az aks nodepool update: den befintliga MW hämtas, dina angivna fält sammanfogas till den och den resulterande brödtexten är TILLBAKA. Fält som du inte anger bevaras as-is (befintliga taggar, befintliga schemaskalarer, befintliga blackout-datum osv.).

När du anger ett schema arg (--schedule-type / --interval-* / --day-of-week / --day-of-month / --week-index) byggs schemaformen om från slutpunkt till slutpunkt från dina args (du kan inte delvis blanda fälten Dag + Vecka – välj en schematyp och ange dess nödvändiga args).

--tags följer aks update konventionen: genom att skicka --tags ersätts hela taggarnas ordlista; utelämna --tags för att behålla de befintliga taggarna.

--location kan inte ändras (TrackedResource-semantik – ARM avvisar platsändringar på PUT). Om det levereras med ett annat värde än den befintliga platsen ignoreras det med en varning.

--config-file: När den tillhandahålls ersätter JSON-filens properties block den befintliga properties grossisten. Detta är det enda sättet idag att mutera notAllowedDates / blackout datumintervall. Enskilda schemaflaggor ignoreras på den här sökvägen. taggar följer samma --tags regel som utan --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}]

Exempel

Uppdatera endast taggar (befintligt schema bevaras).

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

Uppdatera endast schemats veckodag (befintlig varaktighet/starttid/taggar bevarade).

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

Ändra endast varaktighet (befintlig schemaform bevarad).

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

Ersätt blackout-datum via en konfigurationsfil (bevarar taggar, plats).

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" } ]
    }
  }

Obligatoriska parametrar

--name -n

Namn på underhållsperiod.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--config-file

Sökväg till en JSON-fil som beskriver MaintenanceWindow-brödtexten. När den tillhandahålls definierar JSON helt resursen vid skapande eller ersätter det befintliga properties blocket vid uppdatering. Det här är den enda sökvägen som kan ange fält utan dedikerade flaggor (notAllowedDates osv.).

--day-of-month

Dag i månaden underhållet sker för AbsoluteMonthly-schemat.

--day-of-week

Veckodag inträffar underhållet för vecko- eller relativmånadsschemat.

--duration

Längden på underhållsfönstret i timmar. Intervall 4-24.

--interval-days

Antalet dagar mellan varje uppsättning förekomster för dagligt schema.

--interval-months

Antalet månader mellan varje uppsättning förekomster för AbsoluteMonthly- eller RelativeMonthly-schema.

--interval-weeks

Antalet veckor mellan varje uppsättning förekomster för veckoschemat.

--location -l

Location. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Egenskap	Värde
Standardvärde:	False

--schedule-type

Upprepningstyp: Varje dag, Varje vecka, AbsoluteMonthly eller RelativeMonthly.

Egenskap	Värde
Godkända värden:	AbsoluteMonthly, Daily, RelativeMonthly, Weekly

--start-date

Det datum då underhållsfönstret aktiveras. 2026-06-01.

--start-time

Starttiden för underhållsperioden. t.ex. 09:30.

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

--utc-offset

UTC-förskjutningen i formatet +/-HH:mm. t.ex. -08:00 eller +05:30.

--week-index

Instans av veckodagen som anges i --day-of-week underhållet sker för RelativeMonthly-schemat.

Egenskap	Värde
Godkända värden:	First, Fourth, Last, Second, Third

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

az aks maintenancewindow wait

Vänta tills ett UnderhållWindow har nått önskat tillstånd.

Om en åtgärd på ett underhållWindow avbröts eller startades med --no-waitanvänder du det här kommandot för att vänta tills den har slutförts.

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

Exempel

Vänta tills ett UnderhållWindow har skapats.

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

Obligatoriska parametrar

--name -n

Namn på underhållsperiod.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap	Värde
Parametergrupp:	Global Policy Arguments

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

Egenskap	Värde
Parametergrupp:	Wait Condition Arguments
Standardvärde:	False

--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Egenskap	Värde
Parametergrupp:	Wait Condition Arguments

--deleted

Vänta tills den har tagits bort.

Egenskap	Värde
Parametergrupp:	Wait Condition Arguments
Standardvärde:	False

--exists

Vänta tills resursen finns.

Egenskap	Värde
Parametergrupp:	Wait Condition Arguments
Standardvärde:	False

--interval

Avsökningsintervall i sekunder.

Egenskap	Värde
Parametergrupp:	Wait Condition Arguments
Standardvärde:	30

--timeout

Maximal väntetid i sekunder.

Egenskap	Värde
Parametergrupp:	Wait Condition Arguments
Standardvärde:	3600

--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

Egenskap	Värde
Parametergrupp:	Wait Condition Arguments
Standardvärde:	False

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap	Värde
Standardvärde:	False

--output -o

Utdataformat.

Egenskap	Värde
Standardvärde:	json
Godkända värden:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap	Värde
Standardvärde:	False

Feedback

Var den här sidan till hjälp?