你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az load test-run

注意

此参考是 Azure CLI（版本 2.41.0 或更高版本）的负载扩展的一部分。 该扩展将在首次运行 az load test-run 命令时自动安装。 详细了解扩展。

此命令组处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

用于管理负载测试运行的命令组。

使用创建、更新、删除、列出、停止等来管理负载测试运行的命令组。

命令

名称	说明	类型	Status
az load test-run app-component	用于管理负载测试运行应用组件的命令组。	扩展	预览
az load test-run app-component add	将应用组件添加到测试运行。	扩展	预览
az load test-run app-component list	列出测试运行的所有应用组件。	扩展	预览版
az load test-run app-component remove	从测试运行中删除应用组件。	扩展	预览
az load test-run create	创建新的负载测试运行。	扩展	预览
az load test-run delete	删除现有的负载测试运行。	扩展	预览
az load test-run download-files	下载现有负载测试运行的文件。	扩展	预览
az load test-run list	列出所有测试运行。	扩展	预览
az load test-run metrics	用于检索负载测试运行指标的命令组。	扩展	预览
az load test-run metrics get-definitions	获取负载测试运行的所有指标定义。	扩展	预览
az load test-run metrics get-dimensions	获取负载测试运行的所有指标维度值。	扩展	预览
az load test-run metrics get-namespaces	获取负载测试运行的所有指标命名空间。	扩展	预览版
az load test-run metrics list	列出负载测试运行的指标。	扩展	预览
az load test-run server-metric	用于管理负载测试运行服务器指标的命令组。	扩展	预览
az load test-run server-metric add	将服务器指标添加到测试运行。	扩展	预览版
az load test-run server-metric list	列出测试运行的所有服务器指标。	扩展	预览版
az load test-run server-metric remove	从测试运行中删除服务器指标。	扩展	预览
az load test-run show	显示测试运行的详细信息。	扩展	预览
az load test-run stop	停止运行负载测试运行。	扩展	预览
az load test-run update	更新现有的负载测试运行。	扩展	预览

az load test-run create

预览

命令组“负载测试运行”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

创建新的负载测试运行。

为给定的测试创建新的负载测试运行。 如果指定了现有测试运行，则将重新运行测试运行。 默认情况下，此命令将等待测试运行完成。 使用 --no-wait 跳过此等待。

az load test-run create --load-test-resource
                        --test-id
                        --test-run-id
                        [--certificate]
                        [--description]
                        [--display-name]
                        [--env]
                        [--existing-test-run-id]
                        [--no-wait]
                        [--resource-group]
                        [--secret]

示例

为测试创建测试运行，而无需等待测试运行完成。

az load test-run create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --test-run-id sample-test-run-id --no-wait

重新运行现有测试运行。

az load test-run create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --test-run-id sample-test-run-id --description "Test run description" --existing-test-run-id existing_test_run_id

必需参数

--load-test-resource --name -n

负载测试资源的名称或 ARM 资源 ID。

--test-id -t

负载测试的测试 ID。

--test-run-id -r

负载测试运行的测试运行 ID。

可选参数

--certificate

采用“key[=value]”格式的单个证书。 证书应以 PFX 格式以 Azure 密钥库存储，证书标识符应作为值提供。使用“”清除现有证书。

--description

负载测试运行的说明。

--display-name

负载测试运行的显示名称。

--env

空格分隔的环境变量：key[=value] [key[=value] ...]。使用“”清除现有环境变量。

--existing-test-run-id

应重新运行的现有负载测试运行的测试运行 ID。

--no-wait

不等待长时间运行的操作完成。

默认值: False

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--secret

空格分隔的机密：key[=value] [key[=value] ...]。机密应存储在 Azure 密钥库中，并且机密标识符应作为值提供。使用“”清除现有机密。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az load test-run delete

预览

命令组“负载测试运行”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

删除现有的负载测试运行。

az load test-run delete --load-test-resource
                        --test-run-id
                        [--resource-group]
                        [--yes]

示例

删除测试运行。

az load test-run delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --yes

必需参数

--load-test-resource --name -n

负载测试资源的名称或 ARM 资源 ID。

--test-run-id -r

负载测试运行的测试运行 ID。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--yes -y

不提示确认。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az load test-run download-files

预览

命令组“负载测试运行”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

下载现有负载测试运行的文件。

az load test-run download-files --load-test-resource
                                --path
                                --test-run-id
                                [--force]
                                [--input]
                                [--log]
                                [--resource-group]
                                [--result]

示例

下载测试运行的输入、日志和结果文件。 目录应已存在。

az load test-run download-files --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --path ~/Downloads/OutputArtifacts --input --log --result

通过创建目录（如果不存在）来下载测试运行的输入和日志文件。

az load test-run download-files --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --path ~/Downloads/OutputArtifacts --input --log --force

必需参数

--load-test-resource --name -n

负载测试资源的名称或 ARM 资源 ID。

--path

用于下载文件的目录的路径。

--test-run-id -r

负载测试运行的测试运行 ID。

可选参数

--force

强制运行命令。 这将创建目录以下载文件（如果不存在）。

默认值: False

--input

下载输入文件 zip。

默认值: False

--log

下载日志文件 zip。

默认值: False

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--result

下载结果文件 zip。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az load test-run list

预览

命令组“负载测试运行”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

列出所有测试运行。

az load test-run list --load-test-resource
                      --test-id
                      [--resource-group]

示例

列出测试中运行的所有测试。

az load test-run list --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id

必需参数

--load-test-resource --name -n

负载测试资源的名称或 ARM 资源 ID。

--test-id -t

负载测试的测试 ID。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az load test-run show

预览

命令组“负载测试运行”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

显示测试运行的详细信息。

显示由给定的测试运行 ID 标识的测试运行的详细信息。

az load test-run show --load-test-resource
                      --test-run-id
                      [--resource-group]

示例

获取测试运行的详细信息。

az load test-run show --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id

必需参数

--load-test-resource --name -n

负载测试资源的名称或 ARM 资源 ID。

--test-run-id -r

负载测试运行的测试运行 ID。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az load test-run stop

预览

命令组“负载测试运行”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

停止运行负载测试运行。

az load test-run stop --load-test-resource
                      --test-run-id
                      [--resource-group]
                      [--yes]

示例

停止测试运行。

az load test-run stop --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --yes

必需参数

--load-test-resource --name -n

负载测试资源的名称或 ARM 资源 ID。

--test-run-id -r

负载测试运行的测试运行 ID。

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

--yes -y

不提示确认。

默认值: False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az load test-run update

预览

命令组“负载测试运行”处于预览状态，正在开发中。 参考和支持级别： https://aka.ms/CLI_refstatus

更新现有的负载测试运行。

az load test-run update --load-test-resource
                        --test-run-id
                        [--description]
                        [--display-name]
                        [--resource-group]

示例

更新测试运行的说明

az load test-run update --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --description "Test run description"

必需参数

--load-test-resource --name -n

负载测试资源的名称或 ARM 资源 ID。

--test-run-id -r

负载测试运行的测试运行 ID。

可选参数

--description

负载测试运行的说明。

--display-name

负载测试运行的显示名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group=<name> 配置默认组。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

--output -o

输出格式。

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

默认值: json

--query

JMESPath 查询字符串。 有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。