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

az webapp config

注意

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

配置 Web 应用。

命令

名称	说明	类型	Status
az webapp config access-restriction	显示、设置、添加和删除 Web 应用访问限制的方法。	核心	GA
az webapp config access-restriction add	向 Web 应用添加访问限制。	核心	GA
az webapp config access-restriction remove	从 Web 应用中删除访问限制。	核心	GA
az webapp config access-restriction set	设置 SCM 站点是否使用与主站点和默认操作相同的限制。	核心	GA
az webapp config access-restriction show	显示 Webapp 的访问限制设置。	核心	GA
az webapp config appsettings	配置 Web 应用设置。 更新或删除应用程序设置将导致应用回收。	核心	GA
az webapp config appsettings delete	删除 Web 应用设置。	核心	GA
az webapp config appsettings list	获取 Web 应用设置的详细信息。	核心	GA
az webapp config appsettings set	设置 Web 应用的设置。	核心	GA
az webapp config backup	管理 Web 应用的备份。	核心	GA
az webapp config backup create	创建 Web 应用的备份。	核心	GA
az webapp config backup delete	删除 Web 应用备份。	核心	GA
az webapp config backup list	列出 Web 应用的备份。	核心	GA
az webapp config backup restore	从备份还原 Web 应用。	核心	GA
az webapp config backup show	显示 Web 应用的备份计划。	核心	GA
az webapp config backup update	为 Web 应用配置新的备份计划。	核心	GA
az webapp config connection-string	管理 Web 应用的连接字符串。	核心	GA
az webapp config connection-string delete	删除 Web 应用的连接字符串。	核心	GA
az webapp config connection-string list	获取 Web 应用的连接字符串。	核心	GA
az webapp config connection-string set	更新 Web 应用的连接字符串。	核心	GA
az webapp config container	管理现有 Web 应用的容器设置。	核心	GA
az webapp config container delete	删除现有 Web 应用的容器设置。	核心	GA
az webapp config container set	设置现有 Web 应用的容器设置。	核心	GA
az webapp config container show	获取 Web 应用的容器设置的详细信息。	核心	GA
az webapp config hostname	配置 Web 应用的主机名。	核心	GA
az webapp config hostname add	将主机名绑定到 Web 应用。	核心	GA
az webapp config hostname delete	从 Web 应用取消绑定主机名。	核心	GA
az webapp config hostname get-external-ip	获取 Web 应用的面向外部的 IP 地址。	核心	GA
az webapp config hostname list	列出 Web 应用的所有主机名绑定。	核心	GA
az webapp config set	设置 Web 应用的配置。	核心	GA
az webapp config show	获取 Web 应用配置的详细信息。	核心	GA
az webapp config snapshot	管理 Web 应用快照。	核心	GA
az webapp config snapshot list	列出 Web 应用的可还原快照。	核心	GA
az webapp config snapshot restore	还原 Web 应用快照。	核心	GA
az webapp config ssl	为 Web 应用配置 SSL 证书。	核心和扩展	GA
az webapp config ssl bind	将 SSL 证书绑定到 Web 应用。	核心	GA
az webapp config ssl bind (appservice-kube 扩展)	将 SSL 证书绑定到 Web 应用。	扩展	GA
az webapp config ssl create	在 Web 应用中创建主机名的托管证书。	核心	预览
az webapp config ssl delete	从 Web 应用中删除 SSL 证书。	核心	GA
az webapp config ssl import	从密钥库将 SSL 或App 服务证书导入 Web 应用。	核心	GA
az webapp config ssl list	列出 Web 应用的 SSL 证书。	核心	GA
az webapp config ssl show	显示 Web 应用的 SSL 证书的详细信息。	核心	GA
az webapp config ssl unbind	从 Web 应用取消绑定 SSL 证书。	核心	GA
az webapp config ssl unbind (appservice-kube 扩展)	从 Web 应用取消绑定 SSL 证书。	扩展	GA
az webapp config ssl upload	将 SSL 证书上传到 Web 应用。	核心	GA
az webapp config storage-account	管理 Web 应用的 Azure 存储帐户配置。 （仅 Linux Web 应用 和 Windows 容器Web 应用）。	核心	GA
az webapp config storage-account add	将 Azure 存储帐户配置添加到 Web 应用。 （仅 Linux Web 应用 和 Windows 容器Web 应用）。	核心	GA
az webapp config storage-account delete	删除 Web 应用的 Azure 存储帐户配置。 （仅 Linux Web 应用 和 Windows 容器Web 应用）。	核心	GA
az webapp config storage-account list	获取 Web 应用的 Azure 存储帐户配置。 （仅 Linux Web 应用 和 Windows 容器Web 应用）。	核心	GA
az webapp config storage-account update	更新 Web 应用上的现有 Azure 存储帐户配置。 （仅 Linux Web 应用 和 Windows 容器Web 应用）。	核心	GA

az webapp config set

设置 Web 应用的配置。

az webapp config set [--acr-identity]
                     [--acr-use-identity {false, true}]
                     [--always-on {false, true}]
                     [--auto-heal-enabled {false, true}]
                     [--ftps-state {AllAllowed, Disabled, FtpsOnly}]
                     [--generic-configurations]
                     [--http20-enabled {false, true}]
                     [--ids]
                     [--java-container]
                     [--java-container-version]
                     [--java-version]
                     [--linux-fx-version]
                     [--min-tls-version]
                     [--name]
                     [--net-framework-version]
                     [--number-of-workers]
                     [--php-version]
                     [--powershell-version]
                     [--prewarmed-instance-count]
                     [--python-version]
                     [--remote-debugging-enabled {false, true}]
                     [--resource-group]
                     [--runtime]
                     [--slot]
                     [--startup-file]
                     [--subscription]
                     [--use-32bit-worker-process {false, true}]
                     [--vnet-route-all-enabled {false, true}]
                     [--web-sockets-enabled {false, true}]
                     [--windows-fx-version]

示例

打开“alwaysOn”

az webapp config set -g MyResourceGroup -n MyUniqueApp --always-on true

通过名为 params.json 的 JSON 文件设置配置

az webapp config set -g MyResourceGroup -n MyUniqueApp --generic-configurations "@.\params.json"

可选参数

--acr-identity

接受将为 acr 映像拉取设置的系统或用户分配标识。 使用“[system]”来引用系统分配的标识，或使用资源 ID 来引用用户分配的标识。

--acr-use-identity

启用或禁用来自 acr 的拉取映像，请使用托管标识。

接受的值: false, true

--always-on

确保始终加载 Web 应用，而不是在空闲后卸载。 建议在连续运行 Web 作业时使用。

接受的值: false, true

--auto-heal-enabled

启用或禁用自动愈合。

接受的值: false, true

--ftps-state

设置应用的 Ftps 状态值。 默认值为“AllAllowed”。

接受的值: AllAllowed, Disabled, FtpsOnly

--generic-configurations

以对或 @<json_file>. 格式key=value提供站点配置列表。 PowerShell 和 Windows 命令提示符用户应使用 JSON 文件提供这些配置，以避免转义字符的兼容性问题。

--http20-enabled

配置网站以允许客户端通过 http2.0 进行连接。

接受的值: false, true

--ids

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

--java-container

Java 容器，例如 Tomcat、Jetty。

--java-container-version

Java 容器的版本，例如 Tomcat 的“8.0.23”。

--java-version

如果使用 Java（例如 Java 7 的“1.7”，则用于运行 Web 应用的版本，适用于 Java 8 的“1.8”）。

--linux-fx-version

用于基于 Linux 的 Web 应用的运行时堆栈，例如“RUBY|2.5.5”、“NODE|12LTS”、“PHP|7.2”、“DOTNETCORE|2.1”。 有关详细信息，请参阅 https://aka.ms/linux-stacks。

--min-tls-version

SSL 请求所需的最低 TLS 版本，例如“1.0”、“1.1”、“1.2”。

--name -n

Web 应用的名称。 如果未指定，则会随机生成名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--net-framework-version

如果使用 .NET Framework（例如用于 .NET 4.6 的“v4.0”）和用于 .NET 3.5 的“v3.0”，则用于运行 Web 应用的版本。

--number-of-workers

要分配的辅助角色数。

--php-version

使用 PHP（例如 5.5、5.6、7.0）时用于运行 Web 应用的版本。

--powershell-version

使用 PowerShell（例如 7.2）时用于运行函数应用的版本。

--prewarmed-instance-count

函数应用具有的预热实例数。

--python-version

使用 Python（例如 2.7、3.4）时用于运行 Web 应用的版本。

--remote-debugging-enabled

启用或禁用远程调试。

接受的值: false, true

--resource-group -g

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

--runtime

采用 Framework：Version 格式的规范化 Web 运行时，例如“PHP：7.2”。用于 az webapp list-runtimes 可用列表。

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

--startup-file

linux 托管 Web 应用的启动文件，例如用于 Node.js Web 的“process.json”。

--subscription

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

--use-32bit-worker-process

使用 32 位工作进程。

接受的值: false, true

--vnet-route-all-enabled

配置区域 VNet 集成以将所有流量路由到 VNet。

接受的值: false, true

--web-sockets-enabled

启用或禁用 Web 套接字。

接受的值: false, true

--windows-fx-version

用于 Windows 容器 Web 应用的 docker 映像名称，例如 microsoft/nanoserver：ltsc2016。

全局参数

--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 webapp config show

获取 Web 应用配置的详细信息。

az webapp config show [--ids]
                      [--name]
                      [--resource-group]
                      [--slot]
                      [--subscription]

示例

获取 Web 应用配置的详细信息。 （自动生成）

az webapp config show --name MyWebapp --resource-group MyResourceGroup

可选参数

--ids

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

--name -n

Web 应用的名称。 如果未指定，则会随机生成名称。 可以使用 < a0/a0> 配置默认值 az configure --defaults web=<name>。

--resource-group -g

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

--slot -s

槽的名称。 如果未指定，则默认为生产槽。

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