Share via


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

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --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

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --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

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --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

一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --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 來取得完整偵錯記錄。