az maintenance configuration

注意

此參考是 Azure CLI (2.15.0 版或更高版本) 維護 延伸模組的一部分。 當您第一次執行 az maintenance configuration 命令時,擴充功能會自動安裝。 深入了解延伸模組。

使用維護來管理維護組態。

命令

az maintenance configuration create

建立組態記錄。

az maintenance configuration delete

刪除組態記錄。

az maintenance configuration list

取得訂用帳戶內的組態記錄。

az maintenance configuration show

取得組態記錄。

az maintenance configuration update

修補組態記錄。

az maintenance configuration create

建立組態記錄。

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

範例

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"

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--resource-name

資源識別碼。

選擇性參數

--duration --maintenance-window-duration

HH:mm 格式的維護期間。 如果未提供,則會根據提供的維護範圍使用預設值。 範例:05:00。

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

YYYY-MM-DD hh:mm 格式的維護期間有效到期日。 視窗將會建立在提供的時區中,並根據該時區調整為日光節約。 到期日必須設定為未來的日期。 如果未提供,則會將其設定為日期時間上限 9999-12-31 23:59:59。

--extension-properties

取得或設定 maintenanceConfiguration 預期值的 extensionProperties:KEY1=VALUE1 KEY2=VALUE2 ...

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

修補 Linux 電腦特有的輸入參數。 對於 Windows 電腦,請勿傳遞此屬性。

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

張貼工作的清單。 例如 [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] 預期值: json-string/json-file/@json-file。

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

前置工作的清單。 例如 [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}] 預期值: json-string/json-file/@json-file。

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

修補 Windows 電腦特有的輸入參數。 針對 Linux 電腦,請勿傳遞這個屬性。

--location -l

位置。 值的來源:az account list-locations。 您可以使用 az configure --defaults location=<location> 來設定預設位置。

--maintenance-scope

取得或設定組態的 maintenanceScope。

接受的值: All, Extension, Host, InGuestPatch, InResource, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

維護時段預期會遞迴的速率。 速率可以表示為每日、每週或每月排程。 每日排程的格式為 recurEvery:[Frequency as integer]['Day (s) ']。 如果未提供任何頻率,則預設頻率為 1。 每日排程範例為 recurEvery:Day、recurEvery:3Days。 每週排程的格式為 recurEvery:[Frequency as integer]['Week (s) '] [星期一-星期日工作日的選擇性逗號分隔清單]。 每週排程範例為 recurEvery:3Weeks、recurEvery:Week Saturday、Sunday。 每月排程的格式為 [Frequency as integer]['Month (s) '] [以逗號分隔的月份天數清單] 或 [Frequency as integer]['Month (s) '] [Month (First, Second, Third, Last) ] [Weekday Monday-Sunday] [Optional Offset (No.) 天數]。 位移值必須介於 -6 到 6 之間。 每月排程範例為 recurEvery:Month、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

YYYY-MM-DD hh:mm 格式之維護時段的有效開始日期。 開始日期可以設定為目前日期或未來的日期。 視窗將會建立在提供的時區中,並根據該時區調整為日光節約。

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

時區的名稱。 您可以在 PowerShell 中執行 [System.TimeZoneInfo]::GetSystemTimeZones () 來取得時區清單。 範例:太平洋標準時間、UTC、W. 歐洲標準時間、韓國標準時間、Cen。 澳大利亞標準時間。

--namespace

取得或設定資源的命名空間。

--reboot-setting

根據使用者所定義的可能重新開機喜好設定,決定在完成修補作業之後重新開機電腦。

接受的值: Always, IfRequired, Never
--tags

空格分隔標記:key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

--visibility

取得或設定組態的可見度。

接受的值: Custom, Public

az maintenance configuration delete

刪除組態記錄。

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

範例

MaintenanceConfigurations_DeleteForResource

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

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--resource-name

資源識別碼。

選擇性參數

--yes -y

不提示確認。

az maintenance configuration list

取得訂用帳戶內的組態記錄。

az maintenance configuration list

範例

MaintenanceConfigurations_List

az maintenance configuration list

az maintenance configuration show

取得組態記錄。

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

範例

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"

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--resource-name

資源識別碼。

az maintenance configuration update

修補程式組態記錄。

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

範例

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"

必要參數

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

--resource-name

資源識別碼。

選擇性參數

--duration --maintenance-window-duration

HH:mm 格式的維護期間。 如果未提供,則會根據提供的維護範圍使用預設值。 範例:05:00。

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

YYYY-MM-DD hh:mm 格式的維護期間有效到期日。 視窗將會建立在提供的時區中,並根據該時區調整為日光節約。 到期日必須設定為未來的日期。 如果未提供,則會將其設定為日期時間上限 9999-12-31 23:59:59。

--extension-properties

取得或設定 maintenanceConfiguration 預期值的 extensionProperties:KEY1=VALUE1 KEY2=VALUE2 ...

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

修補 Linux 電腦特有的輸入參數。 對於 Windows 電腦,請勿傳遞此屬性。

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

張貼工作的清單。 例如 [{'source' :'runbook', 'taskScope': 'Resource', 'parameters': { 'arg1': 'value1'}}] 預期值: json-string/json-file/@json-file。

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

前置工作的清單。 例如 [{'source' :'runbook', 'taskScope': 'Global', 'parameters': { 'arg1': 'value1'}}] 預期的值: json-string/json-file/@json-file。

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

修補 Windows 電腦的特定輸入參數。 若為 Linux 電腦,請勿傳遞此屬性。

--location -l

位置。 值的來源:az account list-locations。 您可以使用 az configure --defaults location=<location> 來設定預設位置。

--maintenance-scope

取得或設定組態的 maintenanceScope。

接受的值: All, Extension, Host, InGuestPatch, InResource, OSImage, Resource, SQLDB, SQLManagedInstance
--maintenance-window-recur-every --recur-every

[維護] 視窗應該遞迴的速率。 速率可以表示為每日、每週或每月排程。 每日排程會格式化為遞迴:[頻率為整數]['Day (s) ']。 如果未提供任何頻率,則預設頻率為 1。 每日排程範例為 recurEvery:Day、recurEvery:3Days。 每週排程的格式為遞迴:[頻率為整數]['Week (s) '] [星期一-星期日的選擇性逗號分隔清單]。 每週排程範例為 recurEvery:3Weeks、recurEvery:Week Saturday、Sunday。 每月排程的格式為 [Frequency as integer]['Month (s) '] [逗號分隔月份清單] 或 [Frequency as integer]['Month (s) '] [Month (First, Second, Third, Fourth, Last) ] [Weekday Monday-Sunday] [Optional Offset (No.天數) ]。 位移值必須介於 -6 到 6 之間。 每月排程範例為 recurEvery:Month、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

YYYY-MM-DD hh:mm 格式之維護期間的有效開始日期。 開始日期可以設定為目前日期或未來日期。 視窗將會建立在提供的時區中,並根據該時區調整為日光節約。

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

時區的名稱。 您可以在 PowerShell 中執行 [System.TimeZoneInfo]::GetSystemTimeZones () 來取得時區清單。 範例:太平洋標準時間、UTC、W. 歐洲標準時間、韓國標準時間、Cen。 澳大利亞標準時間。

--namespace

取得或設定資源的命名空間。

--reboot-setting

根據使用者所定義的可能重新開機喜好設定,決定在修補作業完成之後重新開機機器。

接受的值: Always, IfRequired, Never
--tags

空格分隔標記:key[=value] [key[=value] ...]。使用 「」 清除現有的標籤。

--visibility

取得或設定組態的可見度。

接受的值: Custom, Public