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

az appservice plan

注意

此命令组具有在 Azure CLI 和至少一个扩展中定义的命令。 安装每个扩展,使其受益于其扩展功能。 详细了解扩展。

管理应用服务计划。

命令

名称 说明 类型 状态
az appservice plan create

创建应用服务计划。

核心 GA
az appservice plan create (appservice-kube 扩展)

创建应用服务计划。

扩展 GA
az appservice plan delete

删除应用服务计划。

核心 GA
az appservice plan list

列出应用服务计划。

核心 GA
az appservice plan list (appservice-kube 扩展)

列出应用服务计划。

扩展 GA
az appservice plan show

获取资源组或一组资源组的应用服务计划。

核心 GA
az appservice plan show (appservice-kube 扩展)

获取资源组或一组资源组的应用服务计划。

扩展 GA
az appservice plan update

更新应用服务计划。

核心 GA
az appservice plan update (appservice-kube 扩展)

更新应用服务计划。 请参阅 https://docs.microsoft.com/azure/app-service/app-service-plan-manage#move-an-app-to-another-app-service-plan 了解详细信息。

扩展 GA

az appservice plan create

创建应用服务计划。

az appservice plan create --name
                          --resource-group
                          [--app-service-environment]
                          [--hyper-v]
                          [--is-linux]
                          [--location]
                          [--no-wait]
                          [--number-of-workers]
                          [--per-site-scaling]
                          [--sku {B1, B2, B3, D1, F1, FREE, I1, I1v2, I2, I2v2, I3, I3v2, I4v2, I5v2, I6v2, P0V3, P1MV3, P1V2, P1V3, P2MV3, P2V2, P2V3, P3MV3, P3V2, P3V3, P4MV3, P5MV3, S1, S2, S3, SHARED, WS1, WS2, WS3}]
                          [--tags]
                          [--zone-redundant]

示例

创建基本应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan

创建包含四个 Linux 辅助角色的标准应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan --is-linux --number-of-workers 4 --sku S1

创建 Windows 容器应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan --hyper-v --sku P1V3

为应用服务环境创建应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan --app-service-environment MyAppServiceEnvironment --sku I1

在不同的订阅中为应用服务环境创建应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan --app-service-environment '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase' --sku I1V2

为不同订阅中的应用服务环境以及与应用服务环境不同的区域中的资源组创建应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan --app-service-environment '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/test-rg/providers/Microsoft.Web/hostingEnvironments/test-ase' --sku I1V2 --location ase-region

必需参数

--name -n

新应用服务计划的名称。

--resource-group -g

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

可选参数

--app-service-environment -e

应用服务环境的名称或 ID。 如果要在与应用服务环境不同的订阅中创建应用服务计划,请使用 --app-service-environment 参数的资源 ID。

--hyper-v

在 Hyper-V 辅助角色上托管 Windows 容器 Web 应用。

--is-linux

在 Linux 辅助角色上托管 Web 应用。

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--no-wait

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

默认值: False
--number-of-workers

要分配的辅助角色数。

默认值: 1
--per-site-scaling

在App 服务计划级别启用按应用缩放,以便独立于托管应用的App 服务计划进行缩放。

默认值: False
--sku

定价层,例如 F1(免费)、D1(共享)、B1(基本小型)、B2(基本中型)、B3(基本大型)、S1(标准小型)、P1V2(高级版 V2 Small)、P2V2(高级版 V2 中型)、P3V2(高级版 高级版 V2 大型)、P0V3(高级版 V3 特小)、P1V3(高级版 V3 小型)、P2V3(高级版 V3 中)、P3V3(高级版 V3 大型)、P1MV3(高级版内存优化 V3 小型)、P2MV3(高级版内存优化 V3 中等)、P3MV3(高级版内存优化 V3 大型)、P4MV3(高级版内存优化 V3 特大)、P5MV3(高级版内存优化 V3 特大),I1 独立小型)、I2(独立中等)、I3(独立大型)、I1v2(独立 V2 Small)、I2v2(独立 V2 中等)、I3v2(独立 V2 Large)、I4v2(独立 V2 I4v2)、I5v2(独立 V2 I5v2), I6v2(独立 V2 I6v2)、WS1(逻辑应用工作流标准 1)、WS2(逻辑应用工作流标准 2)、WS3(逻辑应用工作流标准 3)。

接受的值: B1, B2, B3, D1, F1, FREE, I1, I1v2, I2, I2v2, I3, I3v2, I4v2, I5v2, I6v2, P0V3, P1MV3, P1V2, P1V3, P2MV3, P2V2, P2V3, P3MV3, P3V2, P3V3, P4MV3, P5MV3, S1, S2, S3, SHARED, WS1, WS2, WS3
默认值: B1
--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

--zone-redundant -z

启用区域冗余以实现高可用性。 创建计划后无法更改。 最小实例计数为 3。

默认值: 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 appservice plan create (appservice-kube 扩展)

创建应用服务计划。

az appservice plan create --name
                          --resource-group
                          [--app-service-environment]
                          [--custom-location]
                          [--hyper-v]
                          [--is-linux]
                          [--location]
                          [--no-wait]
                          [--number-of-workers]
                          [--per-site-scaling]
                          [--sku]
                          [--tags]

示例

创建基本应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan

使用四个 Linux 辅助角色创建标准应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan \
    --is-linux --number-of-workers 4 --sku S1

为应用服务环境创建应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan \
    --app-service-environment MyAppServiceEnvironment --sku I1

为 kubernetes 环境创建应用服务计划。

az appservice plan create -g MyResourceGroup -n MyPlan \
    --custom-location /subscriptions/sub_id/resourcegroups/group_name/providers/microsoft.extendedlocation/customlocations/custom_location_name \
    --per-site-scaling --is-linux --sku K1

在与自定义位置相同的资源组中创建 kubernetes 环境应用服务计划

az appservice plan create -g MyResourceGroup -n MyPlan \
    --custom-location custom_location_name \
    --per-site-scaling --is-linux --sku K1

必需参数

--name -n

新应用服务计划的名称。

--resource-group -g

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

可选参数

--app-service-environment -e

应用服务环境的名称或 ID。

--custom-location -c

自定义位置的名称或 ID。 对计划的不同资源组中的自定义位置使用 ID。

--hyper-v
预览

在 Windows 容器上托管 Web 应用。

--is-linux

在 Linux 辅助角色上托管 Web 应用。

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--no-wait

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

默认值: False
--number-of-workers

要分配的辅助角色数。

默认值: 1
--per-site-scaling

在App 服务计划级别启用按应用缩放,以便独立于托管应用的App 服务计划进行缩放。

默认值: False
--sku

定价层,例如 F1(免费)、D1(共享)、B1(基本小型)、B2(基本中型)、B3(基本大型)、S1(标准小型)、P1V2(高级版 V2 小型)、PC2(高级版 容器小型)、PC3(高级版容器中等)、PC4 (高级版容器大型)、I1(独立小型)、I2(独立中等)、I3(独立大型)、I1v2(独立 V2 小型)、I2v2(独立 V2 中型)、I3v2(独立 V2 大型)K1(Kubernetes)。

--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--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 appservice plan delete

删除应用服务计划。

az appservice plan delete [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]
                          [--yes]

示例

删除应用服务计划。 (自动生成)

az appservice plan delete --name MyAppServicePlan --resource-group MyResourceGroup

可选参数

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

应用服务计划的名称。

--resource-group -g

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

--subscription

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

--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 appservice plan list

列出应用服务计划。

az appservice plan list [--resource-group]

示例

列出所有免费层App 服务计划。

az appservice plan list --query "[?sku.tier=='Free']"

列出App 服务环境的所有App 服务计划。

az appservice plan list --query "[?hostingEnvironmentProfile.name=='<ase-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 获取完整的调试日志。

az appservice plan list (appservice-kube 扩展)

列出应用服务计划。

az appservice plan list [--resource-group]

示例

列出所有免费层App 服务计划。

az appservice plan list --query "[?sku.tier=='Free']"

列出App 服务环境的所有App 服务计划。

az appservice plan list --query "[?hostingEnvironmentProfile.name=='<ase-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 获取完整的调试日志。

az appservice plan show

获取资源组或一组资源组的应用服务计划。

az appservice plan show [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

示例

获取资源组或一组资源组的应用服务计划。 (自动生成)

az appservice plan show --name MyAppServicePlan --resource-group MyResourceGroup

可选参数

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

应用服务计划的名称。

--resource-group -g

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

--subscription

订阅的名称或 ID。 可以使用 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

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

--verbose

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

az appservice plan show (appservice-kube 扩展)

获取资源组或一组资源组的应用服务计划。

az appservice plan show [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

示例

获取资源组或一组资源组的应用服务计划。 (自动生成)

az appservice plan show --name MyAppServicePlan --resource-group MyResourceGroup

可选参数

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

应用服务计划的名称。

--resource-group -g

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

--subscription

订阅的名称或 ID。 可以使用 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

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

--verbose

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

az appservice plan update

更新应用服务计划。

有关详细信息,请参阅 https:///go.microsoft.com/fwlink/?linkid=2133856。

az appservice plan update [--add]
                          [--elastic-scale {false, true}]
                          [--force-string]
                          [--ids]
                          [--max-elastic-worker-count]
                          [--name]
                          [--no-wait]
                          [--number-of-workers]
                          [--remove]
                          [--resource-group]
                          [--set]
                          [--sku {B1, B2, B3, D1, F1, FREE, I1, I1v2, I2, I2v2, I3, I3v2, I4v2, I5v2, I6v2, P0V3, P1MV3, P1V2, P1V3, P2MV3, P2V2, P2V3, P3MV3, P3V2, P3V3, P4MV3, P5MV3, S1, S2, S3, SHARED, WS1, WS2, WS3}]
                          [--subscription]

示例

更新应用服务计划。 (自动生成)

az appservice plan update --name MyAppServicePlan --resource-group MyResourceGroup --sku F1

可选参数

--add

通过指定路径和键值对将对象添加到对象列表。 示例:--add property.listProperty <key=value, string or JSON string>

默认值: []
--elastic-scale
预览

启用或禁用自动缩放。 设置为“true”可为此计划启用弹性缩放,或设置为“false”可禁用此计划的弹性缩放。 SKU 必须是高级版 V2 SKU(P1V2、P2V2、P3V2)或 高级版 V3 SKU(P1V3、P2V3、P3V3)。

接受的值: false, true
--force-string

使用“set”或“add”时,保留字符串文本,而不是尝试转换为 JSON。

默认值: False
--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--max-elastic-worker-count -m
预览

计划可横向扩展到的最大实例数。 计划必须是弹性缩放计划。

--name -n

应用服务计划的名称。

--no-wait

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

默认值: False
--number-of-workers

要分配的辅助角色数。

默认值: 1
--remove

从列表中删除属性或元素。 示例: --remove property.list <indexToRemove> OR --remove propertyToRemove.

默认值: []
--resource-group -g

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

--set

通过指定要设置的属性路径和值来更新对象。 示例:--set property1.property2=<value>

默认值: []
--sku

定价层,例如 F1(免费)、D1(共享)、B1(基本小型)、B2(基本中型)、B3(基本大型)、S1(标准小型)、P1V2(高级版 V2 Small)、P2V2(高级版 V2 中型)、P3V2(高级版 高级版 V2 大型)、P0V3(高级版 V3 特小)、P1V3(高级版 V3 小型)、P2V3(高级版 V3 中)、P3V3(高级版 V3 大型)、P1MV3(高级版内存优化 V3 小型)、P2MV3(高级版内存优化 V3 中等)、P3MV3(高级版内存优化 V3 大型)、P4MV3(高级版内存优化 V3 特大)、P5MV3(高级版内存优化 V3 特大),I1 独立小型)、I2(独立中等)、I3(独立大型)、I1v2(独立 V2 Small)、I2v2(独立 V2 中等)、I3v2(独立 V2 Large)、I4v2(独立 V2 I4v2)、I5v2(独立 V2 I5v2), I6v2(独立 V2 I6v2)、WS1(逻辑应用工作流标准 1)、WS2(逻辑应用工作流标准 2)、WS3(逻辑应用工作流标准 3)。

接受的值: B1, B2, B3, D1, F1, FREE, I1, I1v2, I2, I2v2, I3, I3v2, I4v2, I5v2, I6v2, P0V3, P1MV3, P1V2, P1V3, P2MV3, P2V2, P2V3, P3MV3, P3V2, P3V3, P4MV3, P5MV3, S1, S2, S3, SHARED, WS1, WS2, WS3
--subscription

订阅的名称或 ID。 可以使用 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

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

--verbose

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

az appservice plan update (appservice-kube 扩展)

az appservice plan update [--ids]
                          [--name]
                          [--no-wait]
                          [--number-of-workers]
                          [--resource-group]
                          [--sku {ANY, B1, B2, B3, D1, ELASTICANY, F1, FREE, I1, I2, I3, P1V2, P2V2, P3V2, PC2, PC3, PC4, S1, S2, S3, SHARED}]
                          [--subscription]

示例

更新应用服务计划。 (自动生成)

az appservice plan update --name MyAppServicePlan --resource-group MyResourceGroup --sku F1

更新 kubernetes 应用服务计划。

az appservice plan update --name MyAppServicePlan --resource-group MyResourceGroup \
    --sku ANY --number-of-workers 3

可选参数

--ids

一个或多个资源 ID(以空格分隔)。 它应该是包含“Resource Id”参数的所有信息的完整资源 ID。 应提供 --ids 或其他“Resource Id”参数。

--name -n

应用服务计划的名称。

--no-wait

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

默认值: False
--number-of-workers

要分配的辅助角色数。

默认值: 1
--resource-group -g

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

--sku

定价层,例如 F1(免费)、D1(共享)、B1(基本小型)、B2(基本中型)、B3(基本大型)、S1(标准小型)、P1V2(高级版 V2 小型)、PC2(高级版容器小型)、PC3(高级版容器中型)、PC4(高级版容器大)、I1(独立小型)、I2(独立中型)、I3(独立大)、K1(Kubernetes)。

接受的值: ANY, B1, B2, B3, D1, ELASTICANY, F1, FREE, I1, I2, I3, P1V2, P2V2, P3V2, PC2, PC3, PC4, S1, S2, S3, SHARED
--subscription

订阅的名称或 ID。 可以使用 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

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

--verbose

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