Share via

az maintenance configuration

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione di manutenzione per l'interfaccia della riga di comando di Azure (versione 2.56.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az maintenance configuration . Altre informazioni sulle estensioni.

Gestire la configurazione della manutenzione con la manutenzione.

Comandi

Nome Descrizione Tipo Stato
az maintenance configuration create

Creare un record di configurazione.

 Estensione Disponibilità generale
az maintenance configuration delete

Eliminare il record di configurazione.

 Estensione Disponibilità generale
az maintenance configuration list

Elencare i record di configurazione all'interno di una sottoscrizione e di un gruppo di risorse.

 Estensione Disponibilità generale
az maintenance configuration show

Ottiene il record di configurazione.

 Estensione Disponibilità generale
az maintenance configuration update

Aggiornare il record di configurazione.

 Estensione Disponibilità generale

az maintenance configuration create

Creare un record di configurazione.

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

Esempio

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"

Parametri necessari

--name --resource-name -n

Nome configurazione manutenzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--duration --maintenance-window-duration

Durata della finestra di manutenzione in formato HH:mm. Se non specificato, il valore predefinito verrà usato in base all'ambito di manutenzione specificato. Esempio: 05:00.

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

Data di scadenza effettiva della finestra di manutenzione in formato AAAA-MM-GG hh:mm. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario. La data di scadenza deve essere impostata su una data futura. Se non specificato, verrà impostato sul valore datetime massimo 9999-12-31 23:59:59.

--extension-properties

Ottiene o imposta extensionProperties dell'oggetto maintenanceConfiguration Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

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

Parametri di input specifici per l'applicazione di patch al computer Linux. Per i computer Windows, non passare questa proprietà. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

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

Parametri di input specifici per l'applicazione di patch a un computer Windows. Per i computer Linux, non passare questa proprietà. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--location -l

Ottiene o imposta la posizione della risorsa.

--maintenance-scope

Ottiene o imposta maintenanceScope della configurazione.

valori accettati: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Frequenza di ripetizione di una finestra di manutenzione. Il tasso può essere espresso come pianificazioni giornaliere, settimanali o mensili. La pianificazione giornaliera viene formattata come ricorsiva: [Frequency as integer]['Day/s)']. Se non viene specificata alcuna frequenza, la frequenza predefinita è 1. Gli esempi di pianificazione giornaliera sono ricorsivi: Day, recurEvery: 3Days. La pianificazione settimanale viene formattata come ricorsiva: [Frequenza come numero intero][Settimana/i][Elenco delimitato da virgole facoltativo dei giorni feriali lunedì-domenica]. Gli esempi di pianificazione settimanale sono ricorsiva: 3Weeks, recurEvery: Week Saturday,Sunday. Le pianificazioni mensili vengono formattate come [Frequency as integer]['Month/s)'] [Elenco delimitato da virgole di giorni mensili] o [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Il valore di offset deve essere compreso tra -6 e 6 inclusi. Gli esempi di pianificazione mensile sono recurEvery: Month, recurEvery: 2Months, recurevery: Month day23,day24, recurEvery: Month Last Sunday, recury: Month Fourth Monday, recury: Month Last Sunday Offset-3, recury: Month Third Sunday Offset6.

--maintenance-window-start-date-time --start-date-time

Data di inizio effettiva della finestra di manutenzione in formato AAAA-MM-GG hh:mm. La data di inizio può essere impostata sulla data corrente o sulla data futura. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario.

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

Nome del fuso orario. È possibile ottenere l'elenco dei fusi orari eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Esempio: Ora solare pacifico, UTC, Ora solare W. Europa, Ora solare corea, Cen. Ora solare australia.

--namespace

Ottiene o imposta lo spazio dei nomi della risorsa.

--reboot-setting

Possibile preferenza di riavvio definita dall'utente in base alla quale sarebbe stato deciso di riavviare il computer o meno dopo il completamento dell'operazione di patch.

valori accettati: Always, IfRequired, Never
--tags

Ottiene o imposta i tag della risorsa Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

--visibility

Ottiene o imposta la visibilità della configurazione. Il valore predefinito è 'Custom'.

valori accettati: Custom, Public
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az maintenance configuration delete

Eliminare il record di configurazione.

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

Esempio

MaintenanceConfigurations_DeleteForResource

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name --resource-name -n

Nome configurazione manutenzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--yes -y

Indica che non è richiesta la conferma.

valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az maintenance configuration list

Elencare i record di configurazione all'interno di una sottoscrizione e di un gruppo di risorse.

az maintenance configuration list [--resource-group]

Esempio

MaintenanceConfigurations_List

az maintenance configuration list

Parametri facoltativi

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az maintenance configuration show

Ottiene il record di configurazione.

az maintenance configuration show [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

Esempio

MaintenanceConfigurations_GetForResource

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

Parametri facoltativi

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--name --resource-name -n

Nome configurazione manutenzione.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az maintenance configuration update

Aggiornare il record di configurazione.

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

Esempio

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"

Parametri facoltativi

--duration --maintenance-window-duration

Durata della finestra di manutenzione in formato HH:mm. Se non specificato, il valore predefinito verrà usato in base all'ambito di manutenzione specificato. Esempio: 05:00.

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

Data di scadenza effettiva della finestra di manutenzione in formato AAAA-MM-GG hh:mm. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario. La data di scadenza deve essere impostata su una data futura. Se non specificato, verrà impostato sul valore datetime massimo 9999-12-31 23:59:59.

--extension-properties

Ottiene o imposta extensionProperties dell'oggetto maintenanceConfiguration Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

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

Parametri di input specifici per l'applicazione di patch al computer Linux. Per i computer Windows, non passare questa proprietà. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

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

Parametri di input specifici per l'applicazione di patch a un computer Windows. Per i computer Linux, non passare questa proprietà. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--location -l

Ottiene o imposta la posizione della risorsa.

--maintenance-scope

Ottiene o imposta maintenanceScope della configurazione.

valori accettati: Extension, Host, InGuestPatch, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

Frequenza di ripetizione di una finestra di manutenzione. Il tasso può essere espresso come pianificazioni giornaliere, settimanali o mensili. La pianificazione giornaliera viene formattata come ricorsiva: [Frequency as integer]['Day/s)']. Se non viene specificata alcuna frequenza, la frequenza predefinita è 1. Gli esempi di pianificazione giornaliera sono ricorsivi: Day, recurEvery: 3Days. La pianificazione settimanale viene formattata come ricorsiva: [Frequenza come numero intero][Settimana/i][Elenco delimitato da virgole facoltativo dei giorni feriali lunedì-domenica]. Gli esempi di pianificazione settimanale sono ricorsiva: 3Weeks, recurEvery: Week Saturday,Sunday. Le pianificazioni mensili vengono formattate come [Frequency as integer]['Month/s)'] [Elenco delimitato da virgole di giorni mensili] o [Frequency as integer]['Month(s)'] [Week of Month (First, Second, Third, Fourth, Last)] [Weekday Monday-Sunday] [Optional Offset(No. of days)]. Il valore di offset deve essere compreso tra -6 e 6 inclusi. Gli esempi di pianificazione mensile sono recurEvery: Month, recurEvery: 2Months, recurevery: Month day23,day24, recurEvery: Month Last Sunday, recury: Month Fourth Monday, recury: Month Last Sunday Offset-3, recury: Month Third Sunday Offset6.

--maintenance-window-start-date-time --start-date-time

Data di inizio effettiva della finestra di manutenzione in formato AAAA-MM-GG hh:mm. La data di inizio può essere impostata sulla data corrente o sulla data futura. La finestra verrà creata nel fuso orario specificato e regolata in base al fuso orario.

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

Nome del fuso orario. È possibile ottenere l'elenco dei fusi orari eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Esempio: Ora solare pacifico, UTC, Ora solare W. Europa, Ora solare corea, Cen. Ora solare australia.

--name --resource-name -n

Nome configurazione manutenzione.

--namespace

Ottiene o imposta lo spazio dei nomi della risorsa.

--reboot-setting

Possibile preferenza di riavvio definita dall'utente in base alla quale sarebbe stato deciso di riavviare il computer o meno dopo il completamento dell'operazione di patch.

valori accettati: Always, IfRequired, Never
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--tags

Ottiene o imposta i tag della risorsa Support shorthand-syntax, json-file e yaml-file. Prova "??" per mostrare di più.

--visibility

Ottiene o imposta la visibilità della configurazione. Il valore predefinito è 'Custom'.

valori accettati: Custom, Public
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.