az maintenance applyupdate

Note

此參考文獻是Azure CLI維護擴充套件(版本 2.75.0 或更高版本)的一部分。 擴充功能會在您第一次執行 az maintenance applyupdate 命令時自動安裝。 深入了解擴充功能。

使用維護管理套用更新。

命令

名稱 Description 類型 狀態
az maintenance applyupdate create

將維護更新套用至資源。

Extension GA
az maintenance applyupdate create-or-update

建立資源的維護更新。

Extension GA
az maintenance applyupdate create-or-update-parent

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

Extension GA
az maintenance applyupdate list

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

Extension GA
az maintenance applyupdate show

追蹤資源的維護更新。

Extension GA
az maintenance applyupdate show-parent

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

Extension GA
az maintenance applyupdate update

更新資源的維護更新。

Extension GA

az maintenance applyupdate create

將維護更新套用至資源。

az maintenance applyupdate create --provider-name
                                  --resource-group
                                  --resource-name
                                  --resource-type
                                  [--acquire-policy-token]
                                  [--change-reference]

範例

ApplyUpdates_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

資源類型。

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性
參數群組: Global Policy Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False

az maintenance applyupdate create-or-update

建立資源的維護更新。

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

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性
參數群組: Global Policy Arguments
--apply-update-name --name -n

套用更新名稱。

屬性
參數群組: Resource Id Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性
參數群組: Global Policy Arguments
--ids

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

屬性
參數群組: Resource Id Arguments
--last-update-time

上次更新時間。

屬性
參數群組: Properties Arguments
--provider-name

資源提供者名稱。

屬性
參數群組: Resource Id Arguments
--resource-group -g

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

屬性
參數群組: Resource Id Arguments
--resource-id

resourceId。

屬性
參數群組: Properties Arguments
--resource-name

資源識別碼。

屬性
參數群組: Resource Id Arguments
--resource-type

資源類型。

屬性
參數群組: Resource Id Arguments
--status

狀態。

屬性
參數群組: Properties Arguments
接受的值: Cancel, Cancelled, Completed, InProgress, NoUpdatesPending, Pending, RetryLater, RetryNow
--subscription

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

屬性
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False

az maintenance applyupdate create-or-update-parent

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

az maintenance applyupdate create-or-update-parent [--acquire-policy-token]
                                                   [--change-reference]
                                                   [--ids]
                                                   [--provider-name]
                                                   [--resource-group]
                                                   [--resource-name]
                                                   [--resource-parent-name]
                                                   [--resource-parent-type]
                                                   [--resource-type]
                                                   [--subscription]

範例

ApplyUpdates_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"

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性
參數群組: Global Policy Arguments
--ids

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

屬性
參數群組: Resource Id Arguments
--provider-name

資源提供者名稱。

屬性
參數群組: Resource Id Arguments
--resource-group -g

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

屬性
參數群組: Resource Id Arguments
--resource-name

資源識別碼。

屬性
參數群組: Resource Id Arguments
--resource-parent-name

資源父標識碼。

屬性
參數群組: Resource Id Arguments
--resource-parent-type

資源父類型。

屬性
參數群組: Resource Id Arguments
--resource-type

資源類型。

屬性
參數群組: Resource Id Arguments
--subscription

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

屬性
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False

az maintenance applyupdate list

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

az maintenance applyupdate list

範例

ApplyUpdates_List

az maintenance applyupdate list
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False

az maintenance applyupdate show

追蹤資源的維護更新。

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

範例

ApplyUpdates_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

應用更新 ID。

屬性
參數群組: Resource Id Arguments
--ids

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

屬性
參數群組: Resource Id Arguments
--provider-name

資源提供者名稱。

屬性
參數群組: Resource Id Arguments
--resource-group -g

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

屬性
參數群組: Resource Id Arguments
--resource-name

資源識別碼。

屬性
參數群組: Resource Id Arguments
--resource-type

資源類型。

屬性
參數群組: Resource Id Arguments
--subscription

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

屬性
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False

az maintenance applyupdate show-parent

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

az maintenance applyupdate show-parent [--acquire-policy-token]
                                       [--apply-update-name --name]
                                       [--change-reference]
                                       [--ids]
                                       [--provider-name]
                                       [--resource-group]
                                       [--resource-name]
                                       [--resource-parent-name]
                                       [--resource-parent-type]
                                       [--resource-type]
                                       [--subscription]

範例

ApplyUpdates_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"

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性
參數群組: Global Policy Arguments
--apply-update-name --name -n

應用更新 ID。

屬性
參數群組: Resource Id Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性
參數群組: Global Policy Arguments
--ids

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

屬性
參數群組: Resource Id Arguments
--provider-name

資源提供者名稱。

屬性
參數群組: Resource Id Arguments
--resource-group -g

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

屬性
參數群組: Resource Id Arguments
--resource-name

資源識別碼。

屬性
參數群組: Resource Id Arguments
--resource-parent-name

資源父標識碼。

屬性
參數群組: Resource Id Arguments
--resource-parent-type

資源父類型。

屬性
參數群組: Resource Id Arguments
--resource-type

資源類型。

屬性
參數群組: Resource Id Arguments
--subscription

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

屬性
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False

az maintenance applyupdate update

更新資源的維護更新。

az maintenance applyupdate update [--acquire-policy-token]
                                  [--add]
                                  [--apply-update-name --name]
                                  [--change-reference]
                                  [--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]

選擇性參數

下列參數是選擇性參數,但視內容而定,命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性
參數群組: Global Policy Arguments
--add

藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例: --add property.listProperty <key=value, string or JSON string>.

屬性
參數群組: Generic Update Arguments
--apply-update-name --name -n

應用更新 ID。

屬性
參數群組: Resource Id Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性
參數群組: Global Policy Arguments
--force-string

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

屬性
參數群組: Generic Update Arguments
接受的值: 0, 1, f, false, n, no, t, true, y, yes
--ids

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

屬性
參數群組: Resource Id Arguments
--last-update-time

上次更新時間。

屬性
參數群組: Properties Arguments
--provider-name

資源提供者名稱。

屬性
參數群組: Resource Id Arguments
--remove

從清單中移除屬性或專案。 範例: --remove property.list <indexToRemove>--remove propertyToRemove

屬性
參數群組: Generic Update Arguments
--resource-group -g

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

屬性
參數群組: Resource Id Arguments
--resource-id

resourceId。

屬性
參數群組: Properties Arguments
--resource-name

資源識別碼。

屬性
參數群組: Resource Id Arguments
--resource-type

資源類型。

屬性
參數群組: Resource Id Arguments
--set

指定要設定的屬性路徑和值,以更新物件。 範例: --set property1.property2=<value>.

屬性
參數群組: Generic Update Arguments
--status

狀態。

屬性
參數群組: Properties Arguments
接受的值: Cancel, Cancelled, Completed, InProgress, NoUpdatesPending, Pending, RetryLater, RetryNow
--subscription

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

屬性
參數群組: Resource Id Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

屬性
預設值: False
--output -o

輸出格式。

屬性
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性
預設值: False