az webapp config

Configure a web app.

Commands

az webapp config appsettings Configure web app settings. Updating or removing application settings will cause an app recycle.
az webapp config appsettings delete Delete web app settings.
az webapp config appsettings list Get the details of a web app's settings.
az webapp config appsettings set Set a web app's settings.
az webapp config backup Manage backups for web apps.
az webapp config backup create Create a backup of a web app.
az webapp config backup list List backups of a web app.
az webapp config backup restore Restore a web app from a backup.
az webapp config backup show Show the backup schedule for a web app.
az webapp config backup update Configure a new backup schedule for a web app.
az webapp config connection-string Manage a web app's connection strings.
az webapp config connection-string delete Delete a web app's connection strings.
az webapp config connection-string list Get a web app's connection strings.
az webapp config connection-string set Update a web app's connection strings.
az webapp config container Manage web app container settings.
az webapp config container delete Delete a web app container's settings.
az webapp config container set Set a web app container's settings.
az webapp config container show Get details of a web app container's settings.
az webapp config hostname Configure hostnames for a web app.
az webapp config hostname add Bind a hostname to a web app.
az webapp config hostname delete Unbind a hostname from a web app.
az webapp config hostname get-external-ip Get the external-facing IP address for a web app.
az webapp config hostname list List all hostname bindings for a web app.
az webapp config set Set a web app's configuration.
az webapp config show Get the details of a web app's configuration.
az webapp config snapshot Manage web app snapshots.
az webapp config snapshot list List the restorable snapshots for a web app.
az webapp config snapshot restore Restore a web app snapshot.
az webapp config ssl Configure SSL certificates for web apps.
az webapp config ssl bind Bind an SSL certificate to a web app.
az webapp config ssl delete Delete an SSL certificate from a web app.
az webapp config ssl list List SSL certificates for a web app.
az webapp config ssl unbind Unbind an SSL certificate from a web app.
az webapp config ssl upload Upload an SSL certificate to a web app.
az webapp config storage-account Manage a web app's Azure storage account configurations. (Linux Web Apps and Windows Containers Web Apps Only).
az webapp config storage-account add Add an Azure storage account configuration to a web app. (Linux Web Apps and Windows Containers Web Apps Only).
az webapp config storage-account delete Delete a web app's Azure storage account configuration. (Linux Web Apps and Windows Containers Web Apps Only).
az webapp config storage-account list Get a web app's Azure storage account configurations. (Linux Web Apps and Windows Containers Web Apps Only).
az webapp config storage-account update Update an existing Azure storage account configuration on a web app. (Linux Web Apps and Windows Containers Web Apps Only).

az webapp config set

Set a web app's configuration.

az webapp config set [--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]
[--php-version]
[--python-version]
[--remote-debugging-enabled {false, true}]
[--resource-group]
[--slot]
[--startup-file]
[--subscription]
[--use-32bit-worker-process {false, true}]
[--web-sockets-enabled {false, true}]
[--windows-fx-version]

Examples

turn on "alwaysOn"

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

turn on "alwaysOn" through a json with content "{"alwaysOn", true}"

az webapp config set -g MyResourceGroup -n MyUniqueApp --generic-configurations "{"alwaysOn": true}"

Optional Parameters

--always-on

Ensure web app gets loaded all the time, rather unloaded after been idle. Recommended when you have continuous web jobs running.

accepted values: false, true
--auto-heal-enabled

Enable or disable auto heal.

accepted values: false, true
--ftps-state

Set the Ftps state value for an app. Default value is 'AllAllowed'.

accepted values: AllAllowed, Disabled, FtpsOnly
--generic-configurations

Provide site configuration list in a format of either "key=value" pair or "@<json_file>".

--http20-enabled

Configures a web site to allow clients to connect over http2.0.

accepted values: false, true
--ids

One or more resource IDs (space-delimited). If provided, no other 'Resource Id' arguments should be specified.

--java-container

The java container, e.g., Tomcat, Jetty.

--java-container-version

The version of the java container, e.g., '8.0.23' for Tomcat.

--java-version

The version used to run your web app if using Java, e.g., '1.7' for Java 7, '1.8' for Java 8.

--linux-fx-version

The runtime stack used for your linux-based webapp, e.g., "RUBY|2.3", "NODE|6.6", "PHP|5.6", "DOTNETCORE|1.1.0". See https://aka.ms/linux-stacks for more info.

--min-tls-version

The minimum version of TLS required for SSL requests, e.g., '1.0', '1.1', '1.2'.

--name -n

Name of the web app. You can configure the default using 'az configure --defaults web='.

--net-framework-version

The version used to run your web app if using .NET Framework, e.g., 'v4.0' for .NET 4.6 and 'v3.0' for .NET 3.5.

--php-version

The version used to run your web app if using PHP, e.g., 5.5, 5.6, 7.0.

--python-version

The version used to run your web app if using Python, e.g., 2.7, 3.4.

--remote-debugging-enabled

Enable or disable remote debugging.

accepted values: false, true
--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--slot -s

The name of the slot. Default to the productions slot if not specified.

--startup-file

The startup file for linux hosted web apps, e.g. 'process.json' for Node.js web.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--use-32bit-worker-process

Use 32 bits worker process or not.

accepted values: false, true
--web-sockets-enabled

Enable or disable web sockets.

accepted values: false, true
--windows-fx-version

A docker image name used for your windows container web app, e.g., microsoft/nanoserver:ltsc2016.

az webapp config show

Get the details of a web app's configuration.

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

Examples

Get the details of a web app's configuration. (autogenerated)

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

Optional Parameters

--ids

One or more resource IDs (space-delimited). If provided, no other 'Resource Id' arguments should be specified.

--name -n

Name of the web app. You can configure the default using 'az configure --defaults web='.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

--slot -s

The name of the slot. Default to the productions slot if not specified.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.