az maintenance applyupdate

參考

注意

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

使用維護管理套用更新。

命令

名稱	Description	類型	狀態
az maintenance applyupdate create	將維護更新套用至資源。	副檔名	GA
az maintenance applyupdate create-or-update	建立資源的維護更新。	副檔名	GA
az maintenance applyupdate create-or-update-parent	使用父代將維護更新套用至資源。	副檔名	GA
az maintenance applyupdate list	取得訂用帳戶內的組態記錄。	副檔名	GA
az maintenance applyupdate show	追蹤資源的維護更新。	副檔名	GA
az maintenance applyupdate show-parent	使用父代追蹤資源的維護更新。	副檔名	GA
az maintenance applyupdate update	更新資源的維護更新。	副檔名	GA

az maintenance applyupdate create

將維護更新套用至資源。

az maintenance applyupdate create --provider-name
                                  --resource-group
                                  --resource-name
                                  --resource-type

範例

套用更新_CreateOrUpdate

az maintenance applyupdate create --provider-name "Microsoft.Compute" --resource-group "examplerg" --resource-name "smdtest1" --resource-type "virtualMachineScaleSets"

必要參數

--provider-name

資源提供者名稱。

--resource-group -g

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

--resource-name

資源識別碼。

--resource-type

資源類型。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az maintenance applyupdate create-or-update

建立資源的維護更新。

az maintenance applyupdate create-or-update [--apply-update-name]
                                            [--ids]
                                            [--last-update-time]
                                            [--provider-name]
                                            [--resource-group]
                                            [--resource-id]
                                            [--resource-name]
                                            [--resource-type]
                                            [--status {Cancel, Cancelled, Completed, InProgress, NoUpdatesPending, Pending, RetryLater, RetryNow}]
                                            [--subscription]

範例

套用更新_CreateOrUpdate

az maintenance applyupdate create-or-update --apply-update-name "20230921151000" --provider-name "Microsoft.Maintenance" --resource-group "Maintenance-RG-1598" --resource-name "configuration1" --resource-type "maintenanceConfigurations" --status "Cancel"

選擇性參數

--apply-update-name --name -n

ApplyUpdate 名稱。

--ids

一或多個資源識別碼 (以空格分隔)。它應該是完整資源識別碼，其中包含「資源標識碼」引數的所有資訊。您應該提供 --ids 或其他「資源識別碼」引數。

--last-update-time

上次更新時間。

--provider-name

資源提供者名稱。

--resource-group -g

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

--resource-id

resourceId。

--resource-name

資源識別碼。

--resource-type

資源類型。

--status

狀態。

接受的值: Cancel, Cancelled, Completed, InProgress, NoUpdatesPending, Pending, RetryLater, RetryNow

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az maintenance applyupdate create-or-update-parent

使用父代將維護更新套用至資源。

az maintenance applyupdate create-or-update-parent [--ids]
                                                   [--provider-name]
                                                   [--resource-group]
                                                   [--resource-name]
                                                   [--resource-parent-name]
                                                   [--resource-parent-type]
                                                   [--resource-type]
                                                   [--subscription]

範例

套用更新_CreateOrUpdateParent

az maintenance applyupdate create-or-update-parent --provider-name "Microsoft.Compute" --resource-group "examplerg" --resource-name "smdvm1" --resource-parent-name "smdtest1" --resource-parent-type "virtualMachineScaleSets" --resource-type "virtualMachines"

選擇性參數

--ids

--provider-name

資源提供者名稱。

--resource-group -g

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

--resource-name

資源識別碼。

--resource-parent-name

資源父標識碼。

--resource-parent-type

資源父類型。

--resource-type

資源類型。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az maintenance applyupdate list

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

az maintenance applyupdate list

範例

套用更新_List

az maintenance applyupdate list

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az maintenance applyupdate show

追蹤資源的維護更新。

az maintenance applyupdate show [--apply-update-name]
                                [--ids]
                                [--provider-name]
                                [--resource-group]
                                [--resource-name]
                                [--resource-type]
                                [--subscription]

範例

套用更新_Get

az maintenance applyupdate show --name "e9b9685d-78e4-44c4-a81c-64a14f9b87b6" --provider-name "Microsoft.Compute" --resource-group "examplerg" --resource-name "smdtest1" --resource-type "virtualMachineScaleSets"

選擇性參數

--apply-update-name --name -n

ApplyUpdate 標識符。

--ids

--provider-name

資源提供者名稱。

--resource-group -g

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

--resource-name

資源識別碼。

--resource-type

資源類型。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az maintenance applyupdate show-parent

使用父代追蹤資源的維護更新。

az maintenance applyupdate show-parent [--apply-update-name]
                                       [--ids]
                                       [--provider-name]
                                       [--resource-group]
                                       [--resource-name]
                                       [--resource-parent-name]
                                       [--resource-parent-type]
                                       [--resource-type]
                                       [--subscription]

範例

套用更新_GetParent

az maintenance applyupdate show-parent --name "e9b9685d-78e4-44c4-a81c-64a14f9b87b6"  --provider-name "Microsoft.Compute" --resource-group "examplerg" --resource-name "smdvm1" --resource-parent-name "smdtest1" --resource-parent-type "virtualMachineScaleSets"  --resource-type "virtualMachines"

選擇性參數

--apply-update-name --name -n

ApplyUpdate 標識符。

--ids

--provider-name

資源提供者名稱。

--resource-group -g

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

--resource-name

資源識別碼。

--resource-parent-name

資源父標識碼。

--resource-parent-type

資源父類型。

--resource-type

資源類型。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az maintenance applyupdate update

更新資源的維護更新。

az maintenance applyupdate update [--add]
                                  [--apply-update-name]
                                  [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                  [--ids]
                                  [--last-update-time]
                                  [--provider-name]
                                  [--remove]
                                  [--resource-group]
                                  [--resource-id]
                                  [--resource-name]
                                  [--resource-type]
                                  [--set]
                                  [--status {Cancel, Cancelled, Completed, InProgress, NoUpdatesPending, Pending, RetryLater, RetryNow}]
                                  [--subscription]

範例

套用更新_Update

az maintenance applyupdate update --apply-update-name "20230921151000" --provider-name "Microsoft.Maintenance" --resource-group "Maintenance-RG-1598" --resource-name "configuration1" --resource-type "maintenanceConfigurations" --status "Cancel"

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。範例：--add property.listProperty <key=value、string 或 JSON 字串>。

--apply-update-name --name -n

ApplyUpdate 標識符。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--ids

--last-update-time

上次更新時間。

--provider-name

資源提供者名稱。

--remove

從清單中移除屬性或專案。範例：--remove property.list OR --remove 屬性ToRemove。

--resource-group -g

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

--resource-id

resourceId。

--resource-name

資源識別碼。

--resource-type

資源類型。

--set

指定要設定的屬性路徑和值，以更新物件。範例：--set property1.property2=。

--status

狀態。

接受的值: Cancel, Cancelled, Completed, InProgress, NoUpdatesPending, Pending, RetryLater, RetryNow

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az maintenance applyupdate

命令

az maintenance applyupdate create

範例

必要參數

az maintenance applyupdate create-or-update

範例

選擇性參數

az maintenance applyupdate create-or-update-parent

範例

選擇性參數

az maintenance applyupdate list

範例

az maintenance applyupdate show

範例

選擇性參數

az maintenance applyupdate show-parent

範例

選擇性參數

az maintenance applyupdate update

範例

選擇性參數

其他資源