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

az appservice ase

管理App 服务环境。

命令

名称	说明	类型	状态
az appservice ase create	创建应用服务环境。	核心	GA
az appservice ase create-inbound-services	私人 DNS内部（ILB）App 服务环境的区域。	核心	预览版
az appservice ase delete	删除应用服务环境。	核心	GA
az appservice ase list	列出应用服务环境。	核心	GA
az appservice ase list-addresses	列出与应用服务环境 v2 关联的 VIP。	核心	GA
az appservice ase list-plans	列出与应用服务环境关联的应用服务计划。	核心	GA
az appservice ase send-test-notification	在应用服务环境 v3 中发送测试升级通知。	核心	预览
az appservice ase show	显示应用服务环境的详细信息。	核心	GA
az appservice ase update	更新应用服务环境。	核心	GA
az appservice ase upgrade	升级应用服务环境 v3。	核心	预览

az appservice ase create

创建应用服务环境。

az appservice ase create --name
                         --resource-group
                         --subnet
                         [--force-network-security-group {false, true}]
                         [--force-route-table {false, true}]
                         [--front-end-scale-factor]
                         [--front-end-sku {I1, I2, I3}]
                         [--ignore-network-security-group {false, true}]
                         [--ignore-route-table {false, true}]
                         [--ignore-subnet-size-validation {false, true}]
                         [--kind {ASEv2, ASEv3}]
                         [--location]
                         [--no-wait]
                         [--os-preference {Linux, Windows}]
                         [--virtual-ip-type {External, Internal}]
                         [--vnet-name]
                         [--zone-redundant {false, true}]

示例

使用默认值创建资源组、虚拟网络和App 服务 Environment v3。

az group create -g MyResourceGroup --location westeurope

az network vnet create -g MyResourceGroup -n MyVirtualNetwork \
  --address-prefixes 10.0.0.0/16 --subnet-name MyAseSubnet --subnet-prefixes 10.0.0.0/24

az appservice ase create -n MyAseName -g MyResourceGroup --vnet-name MyVirtualNetwork \
  --subnet MyAseSubnet --kind asev3

在现有资源组中创建外部App 服务环境 v3 并虚拟网络。

az appservice ase create -n MyAseName -g MyResourceGroup --vnet-name MyVirtualNetwork \
  --subnet MyAseSubnet --virtual-ip-type External --kind asev3

在现有资源组中小于建议的子网中创建虚拟网络和App 服务 Environment v3。

az network vnet create -g MyResourceGroup -n MyVirtualNetwork \
  --address-prefixes 10.0.0.0/16 --subnet-name MyAseSubnet --subnet-prefixes 10.0.0.0/26

az appservice ase create -n MyAseName -g MyResourceGroup --vnet-name MyVirtualNetwork \
  --subnet MyAseSubnet --ignore-subnet-size-validation --kind asev3

使用默认值创建外部区域冗余App 服务环境 v3。

az appservice ase create -n MyASEv3Name -g ASEv3ResourceGroup \
  --vnet-name MyASEv3VirtualNetwork --subnet MyASEv3Subnet --kind asev3 \
  --zone-redundant --virtual-ip-type External

必需参数

--name -n

应用服务环境的名称。

--resource-group -g

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

--subnet

现有子网的名称或 ID。 若要创建 vnet 和/或子网，请使用 az network vnet [subnet] create。

可选参数

--force-network-security-group

覆盖子网的网络安全组。 仅适用于 A标准版v2。

接受的值: false, true

默认值: False

--force-route-table

重写子网的路由表。 仅适用于 A标准版v2。

接受的值: false, true

默认值: False

--front-end-scale-factor

前端到应用服务计划实例比率的缩放。 仅适用于 A标准版v2。

默认值: 15

--front-end-sku

前端服务器的大小。 仅适用于 A标准版v2。

接受的值: I1, I2, I3

默认值: I1

--ignore-network-security-group

手动配置网络安全组。 仅适用于 A标准版v2。

接受的值: false, true

默认值: False

--ignore-route-table

手动配置路由表。 仅适用于 A标准版v2。

接受的值: false, true

默认值: False

--ignore-subnet-size-validation

如果子网大小根据建议进行调整，请不要检查。

接受的值: false, true

默认值: False

--kind -k

指定App 服务环境版本。

接受的值: ASEv2, ASEv3

默认值: ASEv3

--location -l

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

--no-wait

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

默认值: False

--os-preference

确定应用服务环境是否应从 Linux 辅助角色开始。 仅适用于 A标准版v2。

接受的值: Linux, Windows

--virtual-ip-type

指定是否应从 Internet 访问应用服务环境。

接受的值: External, Internal

默认值: Internal

--vnet-name

vNet 的名称。 如果仅指定子网名称，则为必需。

--zone-redundant

将App 服务环境配置为区域冗余。 仅适用于 A标准版v3。

接受的值: false, true

全局参数

--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 ase create-inbound-services

预览

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

私人 DNS内部（ILB）App 服务环境的区域。

az appservice ase create-inbound-services --name
                                          --resource-group
                                          --subnet
                                          [--skip-dns {false, true}]
                                          [--vnet-name]

示例

创建私人 DNS区域和 A 记录。

az appservice ase create-inbound-services -n MyASEName -g ASEResourceGroup \
  --vnet-name MyASEVirtualNetwork --subnet MyAseSubnet

必需参数

--name -n

应用服务环境的名称。

--resource-group -g

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

--subnet

DNS 区域链接的现有子网的名称或 ID。 若要创建 vnet 和/或子网，请使用 az network vnet [subnet] create。

可选参数

--skip-dns

已放弃

参数“skip_dns”已被弃用，将在版本“3.0.0”中删除。

不要创建私人 DNS区域和 DNS 记录。

接受的值: false, true

默认值: False

--vnet-name

vNet 的名称。 如果仅指定子网名称，则为必需。

全局参数

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

删除应用服务环境。

az appservice ase delete --name
                         [--no-wait]
                         [--resource-group]
                         [--yes]

示例

删除应用服务环境。

az appservice ase delete -n MyAseName

必需参数

--name -n

应用服务环境的名称。

可选参数

--no-wait

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

默认值: False

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

列出应用服务环境。

az appservice ase list [--resource-group]

示例

列出订阅中的所有应用服务环境。

az appservice ase list

列出资源组中的所有应用服务环境。

az appservice ase list --resource-group MyResourceGroup

可选参数

--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 ase list-addresses

列出与应用服务环境 v2 关联的 VIP。

az appservice ase list-addresses --name
                                 [--resource-group]

示例

列出应用服务环境的 VIP。

az appservice ase list-addresses --name MyAseName

必需参数

--name -n

应用服务环境的名称。

可选参数

--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 ase list-plans

列出与应用服务环境关联的应用服务计划。

az appservice ase list-plans --name
                             [--resource-group]

示例

列出应用服务环境的应用服务计划。

az appservice ase list-plans --name MyAseName

必需参数

--name -n

应用服务环境的名称。

可选参数

--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 ase send-test-notification

预览

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

在应用服务环境 v3 中发送测试升级通知。

az appservice ase send-test-notification --name
                                         [--resource-group]

示例

在应用服务环境 v3 中发送测试升级通知。

az appservice ase send-test-notification -n MyAseV3Name -g MyResourceGroup

必需参数

--name -n

应用服务环境的名称。

可选参数

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

显示应用服务环境的详细信息。

az appservice ase show --name
                       [--resource-group]

示例

显示应用服务环境。

az appservice ase show --name MyAseName

必需参数

--name -n

应用服务环境的名称。

可选参数

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

更新应用服务环境。

az appservice ase update --name
                         [--allow-incoming-ftp-connections {false, true}]
                         [--allow-new-private-endpoint-connections {false, true}]
                         [--allow-remote-debugging {false, true}]
                         [--front-end-scale-factor]
                         [--front-end-sku {I1, I2, I3}]
                         [--no-wait]
                         [--resource-group]

示例

使用中等前端和比例系数 10 更新应用服务环境 v2。

az appservice ase update -n MyAseV2Name -g MyResourceGroup --front-end-sku I2 \
  --front-end-scale-factor 10

更新应用服务环境 v3 以允许新的专用终结点连接。

az appservice ase update -n MyAseV3Name -g MyResourceGroup --allow-new-private-endpoint-connections

更新应用服务环境 v3 以允许传入 ftp 连接。

az appservice ase update -n MyAseV3Name -g MyResourceGroup --allow-incoming-ftp-connections

更新应用服务环境 v3 以允许远程调试。

az appservice ase update -n MyAseV3Name -g MyResourceGroup --allow-remote-debugging

必需参数

--name -n

应用服务环境的名称。

可选参数

--allow-incoming-ftp-connections -f

（A标准版v3） 配置App 服务环境以允许 FTP 访问。 此 ftpEnabled 设置允许或拒绝App 服务环境级别的 FTP 连接。 单个应用仍需配置 FTP 访问。

接受的值: false, true

--allow-new-private-endpoint-connections -p

（A标准版v3） 在 App 服务 环境中配置应用以允许新的专用终结点连接。

接受的值: false, true

--allow-remote-debugging -r

（A标准版v3） 配置App 服务环境以允许远程调试。 你仍必须在单个应用级别配置远程调试。

接受的值: false, true

--front-end-scale-factor

（A标准版v2） 前端到应用服务计划实例比率在 5 到 15 之间的缩放。

--front-end-sku

（A标准版v2）前端服务器的大小。

接受的值: I1, I2, I3

--no-wait

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

默认值: False

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

预览

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

升级应用服务环境 v3。

az appservice ase upgrade --name
                          [--no-wait]
                          [--resource-group]
                          [--yes]

示例

升级应用服务环境 v3。

az appservice ase upgrade -n MyAseV3Name -g MyResourceGroup

必需参数

--name -n

应用服务环境的名称。

可选参数

--no-wait

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

默认值: False

--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 获取完整的调试日志。