az load

Note

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

管理 Azure 負載測試資源。

命令

名稱	Description	類型	狀態
az load create	建立 Azure 負載測試資源。	Extension	GA
az load delete	刪除 Azure 負載測試資源。	Extension	GA
az load list	列出 Azure 負載測試資源。	Extension	GA
az load notification-rule	管理通知規則的命令群組。	Extension	Preview
az load notification-rule create	建立負載測試資源的新通知規則。	Extension	Preview
az load notification-rule delete	刪除負載測試資源的指定通知規則。	Extension	Preview
az load notification-rule list	列出負載測試資源的所有通知規則。	Extension	Preview
az load notification-rule show	取得負載測試資源的指定通知規則。	Extension	Preview
az load notification-rule update	更新負載測試資源的現有通知規則。	Extension	Preview
az load show	顯示一或多個 Azure 負載測試資源的詳細數據。	Extension	GA
az load test	管理負載測試的命令群組。	Extension	Preview
az load test-run	管理負載測試回合的命令群組。	Extension	Preview
az load test-run app-component	管理負載測試執行應用程式元件的命令群組。	Extension	Preview
az load test-run app-component add	將應用程式元件新增至測試回合。	Extension	Preview
az load test-run app-component list	列出測試回合的所有應用程式元件。	Extension	Preview
az load test-run app-component remove	從測試回合中移除應用程式元件。	Extension	Preview
az load test-run create	建立新的負載測試回合。	Extension	Preview
az load test-run delete	刪除現有的負載測試回合。	Extension	Preview
az load test-run download-files	下載現有負載測試回合的檔案。	Extension	Preview
az load test-run get-artifacts-url	傳回SAS URL以從記憶體帳戶取得成品。	Extension	Preview
az load test-run list	列出所有測試回合。	Extension	Preview
az load test-run metrics	擷取負載測試回合計量的命令群組。	Extension	Preview
az load test-run metrics get-definitions	取得負載測試回合的所有計量定義。	Extension	Preview
az load test-run metrics get-dimensions	取得負載測試回合的所有計量維度值。	Extension	Preview
az load test-run metrics get-namespaces	取得負載測試回合的所有計量命名空間。	Extension	Preview
az load test-run metrics list	列出負載測試回合的計量。	Extension	Preview
az load test-run server-metric	管理負載測試回合伺服器計量的命令群組。	Extension	Preview
az load test-run server-metric add	將伺服器計量新增至測試回合。	Extension	Preview
az load test-run server-metric list	列出測試回合的所有伺服器計量。	Extension	Preview
az load test-run server-metric remove	從測試回合中移除伺服器計量。	Extension	Preview
az load test-run show	顯示測試回合的詳細數據。	Extension	Preview
az load test-run stop	停止執行負載測試回合。	Extension	Preview
az load test-run update	更新現有的負載測試回合。	Extension	Preview
az load test app-component	管理應用程式元件的命令群組。	Extension	Preview
az load test app-component add	將應用程式元件新增至測試。	Extension	Preview
az load test app-component list	列出測試的所有應用程式元件。	Extension	Preview
az load test app-component remove	從測試中移除指定的應用程式元件。	Extension	Preview
az load test compare-to-baseline	比較最近測試回合的取樣器統計數據與基準測試回合的統計數據。	Extension	Preview
az load test convert-to-jmx	將 URL 類型測試轉換為 JMX 測試。	Extension	Preview
az load test create	建立新的負載測試。	Extension	Preview
az load test delete	刪除現有的負載測試。	Extension	Preview
az load test download-files	下載現有負載測試的檔案。	Extension	Preview
az load test file	測試檔案作業的命令群組。	Extension	Preview
az load test file delete	從測試中刪除檔案。	Extension	Preview
az load test file download	從測試下載檔案。	Extension	Preview
az load test file list	列出測試中的所有檔案。	Extension	Preview
az load test file upload	將檔案上傳至測試。	Extension	Preview
az load test list	列出指定負載測試資源中的所有測試。	Extension	Preview
az load test server-metric	管理伺服器計量的命令群組。	Extension	Preview
az load test server-metric add	將伺服器計量新增至測試。	Extension	Preview
az load test server-metric list	列出測試的所有伺服器計量。	Extension	Preview
az load test server-metric remove	從測試中移除指定的伺服器計量。	Extension	Preview
az load test set-baseline	將測試回合設定為比較基準，以便與測試中的其他回合進行比較。	Extension	Preview
az load test show	顯示測試的詳細數據。	Extension	Preview
az load test update	更新現有的負載測試。	Extension	Preview
az load trigger	管理觸發程式的命令群組。	Extension	Preview
az load trigger schedule	管理排程觸發程式的命令群組。	Extension	Preview
az load trigger schedule create	建立新的負載觸發程式排程。	Extension	Preview
az load trigger schedule delete	刪除載入觸發程式排程。	Extension	Preview
az load trigger schedule enable	啟用排程觸發程式。	Extension	Preview
az load trigger schedule list	列出所有排程觸發程式。	Extension	Preview
az load trigger schedule pause	暫停排程觸發程式。	Extension	Preview
az load trigger schedule show	顯示負載觸發程式排程的詳細數據。	Extension	Preview
az load trigger schedule update	更新負載觸發程式排程。	Extension	Preview
az load update	更新 Azure 負載測試資源。	Extension	GA
az load wait	將 CLI 置於等候狀態，直到符合條件為止。	Extension	GA

az load create

建立 Azure 負載測試資源。

負載測試資源名稱必須是唯一的資源群組。

az load create --name
               --resource-group
               [--encryption-identity]
               [--encryption-key]
               [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
               [--location]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--tags]
               [--user-assigned]

範例

建立新的 Azure 負載測試資源

az load create --name sample-resource --resource-group sample-rg --location westus2
az load create -n sample-resource -g sample-rg -l westus2

使用標籤建立新的 Azure 負載測試資源

az load create -n sample-resource -g sample-rg -l westus2 --tags type=testing target=infra

使用受控識別建立新的 Azure 負載測試資源

az load create -n sample-resource -g sample-rg -l westus2 --identity-type SystemAssigned,UserAssigned --user-assigned "{'/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-mi':{}}"

使用 CMK 加密建立新的 Azure 負載測試資源

az load create -n sample-resource -g sample-rg -l westus2 --identity-type SystemAssigned,UserAssigned --user-assigned "{'/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-mi':{}}" --encryption-key https://sample-kv.vault.azure.net/keys/samplekey/2d1ccd5c50234ea2a0858fe148b69cde --encryption-identity /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-mi

必要參數

--name -n

新 Azure 負載測試資源的名稱。

屬性	值
參數群組:	Required Parameters Arguments

--resource-group -g

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

屬性	值
參數群組:	Required Parameters Arguments

選擇性參數

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

--encryption-identity

客戶自控金鑰設定的受控識別，定義應該用來向 Key Vault 進行驗證的身分識別。

屬性	值
參數群組:	Optional Parameters Arguments

--encryption-key

加密金鑰 URL，已建立版本。 例如： https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 。

屬性	值
參數群組:	Optional Parameters Arguments

--identity-type

受控服務識別的類型。

屬性	值
參數群組:	Optional Parameters Arguments
預設值:	None
接受的值:	None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned

--location -l

Location. 來自：az account list-locations 的值。 您可以使用 az configure --defaults location=<location>來設定預設位置。 未指定時，將會使用資源群組的位置。

屬性	值
參數群組:	Required Parameters Arguments

--no-wait

請勿等候長時間執行的作業完成。

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

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Optional Parameters Arguments

--user-assigned

與資源相關聯的使用者指派身分識別清單。 使用者指派的身分識別將會是 ARM 資源識別碼。例如，使用者指派的身分識別清單看起來會像 “{'/subscriptions/ abcdef01-2345-6789-0abc-def012345678 /resourcegroups/sample-rg/providers/microsoft.managedidentity/userassignedidentities/identity1'，'/subscriptions/ abcdef01-2345-6789-0abc-def012345678 /resourcegroups/test-rg/providers/microsoft.managedidentity/userassignedidentities/identity2'}” 支持簡短語法， json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Optional Parameters 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 load delete

刪除 Azure 負載測試資源。

az load delete [--ids]
               [--name]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--resource-group]
               [--subscription]
               [--yes]

範例

刪除 Azure 負載測試資源

az load delete --name sample-resource --resource-group sample-rg

刪除多個 Azure 負載測試資源

az load delete --ids /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.LoadTestService/loadtests/sample-resource1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg2/providers/Microsoft.LoadTestService/loadtests/sample-resource2

選擇性參數

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name -n

Azure 負載測試資源的名稱。

屬性	值
參數群組:	Resource Id Arguments

--no-wait

請勿等候長時間執行的作業完成。

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

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--yes -y

請勿提示確認。

屬性	值
預設值:	False

全域參數

--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 load list

列出 Azure 負載測試資源。

az load list [--resource-group]

範例

列出 Azure 負載測試資源

az load list --resource-group sample-rg
az load list

選擇性參數

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

--resource-group -g

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

屬性	值
參數群組:	Optional Parameters 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 load show

顯示一或多個 Azure 負載測試資源的詳細數據。

az load show [--ids]
             [--name]
             [--resource-group]
             [--subscription]

範例

顯示 Azure 負載測試資源

az load show --name sample-resource --resource-group sample-rg

顯示 Azure 負載測試資源

az load show --ids /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.LoadTestService/loadtests/sample-resource1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg2/providers/Microsoft.LoadTestService/loadtests/sample-resource2

選擇性參數

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

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name -n

Azure 負載測試資源的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	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 load update

更新 Azure 負載測試資源。

az load update [--encryption-identity]
               [--encryption-key]
               [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
               [--ids]
               [--name]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--resource-group]
               [--subscription]
               [--tags]
               [--user-assigned]

範例

更新 Azure 負載測試資源

az load update --name sample-resource --resource-group sample-rg --identity-type SystemAssigned
az load update --name sample-resource --resource-group sample-rg --tags type=server
az load update --name sample-resource --resource-group sample-rg --encryption-key https://sample-kv.vault.azure.net/keys/samplekey2/2d1ccd5c50234ea2a0858fe148b69cde
az load update --name sample-resource --resource-group sample-rg --identity-type SystemAssigned,UserAssigned --user-assigned "{'/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-mi':{}}" --encryption-key https://sample-kv.vault.azure.net/keys/samplekey2/2d1ccd5c50234ea2a0858fe148b69cde --encryption-identity SystemAssigned

選擇性參數

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

--encryption-identity

客戶自控金鑰設定的受控識別，定義應該用來向 Key Vault 進行驗證的身分識別。

屬性	值
參數群組:	Optional Parameters Arguments

--encryption-key

加密金鑰 URL，已建立版本。 例如： https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78 。

屬性	值
參數群組:	Optional Parameters Arguments

--identity-type

受控服務識別的類型。

屬性	值
參數群組:	Optional Parameters Arguments
接受的值:	None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--name -n

Azure 負載測試資源的名稱。

屬性	值
參數群組:	Resource Id Arguments

--no-wait

請勿等候長時間執行的作業完成。

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

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Optional Parameters Arguments

--user-assigned

與資源相關聯的使用者指派身分識別清單。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

屬性	值
參數群組:	Optional Parameters 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 load wait

將 CLI 置於等候狀態，直到符合條件為止。

az load wait [--created]
             [--custom]
             [--deleted]
             [--exists]
             [--ids]
             [--interval]
             [--name]
             [--resource-group]
             [--subscription]
             [--timeout]
             [--updated]

選擇性參數

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

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

屬性	值
參數群組:	Wait Condition Arguments

--deleted

等到刪除為止。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--exists

等候資源存在。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

--ids

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

屬性	值
參數群組:	Resource Id Arguments

--interval

輪詢間隔以秒為單位。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	30

--name -n

Azure 負載測試資源的名稱。

屬性	值
參數群組:	Resource Id Arguments

--resource-group -g

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

屬性	值
參數群組:	Resource Id Arguments

--subscription

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

屬性	值
參數群組:	Resource Id Arguments

--timeout

以秒為單位的等候上限。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	3600

--updated

等到 provisioningState 更新為 'Succeeded'。

屬性	值
參數群組:	Wait Condition Arguments
預設值:	False

全域參數

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