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

Set-AzWebApp

修改 Azure Web 应用。

语法

S1

Set-AzWebApp
    [[-AppServicePlan] <String>]
    [[-DefaultDocuments] <String[]>]
    [[-NetFrameworkVersion] <String>]
    [[-PhpVersion] <String>]
    [[-RequestTracingEnabled] <Boolean>]
    [[-HttpLoggingEnabled] <Boolean>]
    [[-DetailedErrorLoggingEnabled] <Boolean>]
    [[-AppSettings] <Hashtable>]
    [[-ConnectionStrings] <Hashtable>]
    [[-HandlerMappings] <System.Collections.Generic.IList`1[Microsoft.Azure.Management.WebSites.Models.HandlerMapping]>]
    [[-ManagedPipelineMode] <String>]
    [[-WebSocketsEnabled] <Boolean>]
    [[-Use32BitWorkerProcess] <Boolean>]
    [[-AutoSwapSlotName] <String>]
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-ContainerImageName <String>]
    [-ContainerRegistryUrl <String>]
    [-ContainerRegistryUser <String>]
    [-ContainerRegistryPassword <SecureString>]
    [-EnableContainerContinuousDeployment <Boolean>]
    [-HostNames <String[]>]
    [-NumberOfWorkers <Int32>]
    [-AsJob]
    [-AssignIdentity <Boolean>]
    [-HttpsOnly <Boolean>]
    [-AzureStoragePath <WebAppAzureStoragePath[]>]
    [-AlwaysOn <Boolean>]
    [-MinTlsVersion <String>]
    [-FtpsState <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

S2

Set-AzWebApp
    [[-Use32BitWorkerProcess] <Boolean>]
    [[-AutoSwapSlotName] <String>]
    [-WebApp] <PSSite>
    [-NumberOfWorkers <Int32>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

说明

Set-AzWebApp cmdlet 设置 Azure Web 应用。

示例

示例 1

Set-AzWebApp -ResourceGroupName "Default-Web-WestUS" -Name "ContosoWebApp" -AppServicePlan "ContosoPlan"

此命令将更改与资源组 Default-Web-WestUS 关联的 Web App ContosoWebApp 关联的 appservice 计划。 使用此链接了解有关更改应用服务计划和与之关联的约束的详细信息。https://learn.microsoft.com/azure/app-service/app-service-plan-manage#move-an-app-to-another-app-service-plan

示例 2

Set-AzWebApp -ResourceGroupName "Default-Web-WestUS" -Name "ContosoWebApp" -HttpLoggingEnabled $true

此命令将与资源组 Default-Web-WestUS 关联的 Web App ContosoWebApp 的 HttpLoggingEnabled 设置为 true

示例 3

修改 Azure Web 应用。 (autogenerated)

Set-AzWebApp -AppSettings <Hashtable> -Name 'ContosoWebApp' -ResourceGroupName 'Default-Web-WestUS'

示例 4

以下示例为 Web App ContosoWebApp 创建名为 myConnectionString 的 连接字符串。 这将替换 Web App ContosoWebApp 的所有现有连接字符串。

$hashtable =  @{myConnectionString = @{Type='MySql';Value='MySql Connection string'}}
Set-AzWebApp -Name 'ContosoWebApp' -ResourceGroupName 'Default-Web-WestUS' -ConnectionStrings $hashtable

示例 5

为 Web 应用启用 Application Insights

$key=(Get-AzApplicationInsights -ResourceId $ai).InstrumentationKey
$setting=@{"ApplicationInsightsAgent_EXTENSION_VERSION"="~3"; "APPINSIGHTS_INSTRUMENTATIONKEY"=$key}
Set-AzWebApp -AppSettings $setting -Name 'ContosoWebApp' -ResourceGroupName 'Default-Web-WestUS'

参数

-AlwaysOn

确保始终加载 Web 应用,而不是在空闲后卸载。

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AppServicePlan

应用服务计划名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:2
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AppSettings

应用设置哈希表。 将替换现有应用设置,删除未提供的任何设置。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:9
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AsJob

在后台运行 cmdlet

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AssignIdentity

在现有 Azure Webapp 或 functionapp 上启用/禁用 MSI

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AutoSwapSlotName

自动交换的目标槽名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:15
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AzureStoragePath

要装载到用于容器的 Web 应用中的 Azure 存储。 使用 New-AzWebAppAzureStoragePath 创建

参数属性

类型:

WebAppAzureStoragePath[]

默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ConnectionStrings

连接字符串哈希表

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:10
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContainerImageName

容器映像名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContainerRegistryPassword

专用容器注册表密码

参数属性

类型:SecureString
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContainerRegistryUrl

专用容器注册表服务器 URL

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ContainerRegistryUser

专用容器注册表用户名

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultDocuments

默认文档字符串数组

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:3
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DetailedErrorLoggingEnabled

已启用详细错误日志记录的布尔值

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:8
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-EnableContainerContinuousDeployment

启用/禁用容器持续部署 Webhook

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FtpsState

设置应用的 Ftps 状态值。 允许的值 [AllAllowed |已禁用 |FtpsOnly]。

参数属性

类型:String
默认值:None
接受的值:AllAllowed, Disabled, FtpsOnly
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-HandlerMappings

处理程序映射 IList

参数属性

类型:

IList<T>[Microsoft.Azure.Management.WebSites.Models.HandlerMapping]

默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:11
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-HostNames

WebApp 主机名字符串数组

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-HttpLoggingEnabled

HttpLoggingEnabled 布尔值

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:7
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-HttpsOnly

启用/禁用将所有流量重定向到现有 Azure Web 应用或 functionapp 上的 HTTPS

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ManagedPipelineMode

托管管道模式名称

参数属性

类型:String
默认值:None
接受的值:Classic, Integrated
支持通配符:False
不显示:False

参数集

S1
Position:12
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MinTlsVersion

SSL 请求所需的最低 TLS 版本。 允许的值 [1.0 | 1.1 | 1.2]。

参数属性

类型:String
默认值:None
接受的值:1.0, 1.1, 1.2
支持通配符:False
不显示:False

参数集

S1
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

WebApp 名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-NetFrameworkVersion

Net Framework 版本

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:4
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NumberOfWorkers

要分配的辅助角色数

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PhpVersion

Php 版本

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:5
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-RequestTracingEnabled

请求跟踪已启用

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:6
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

资源组名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Use32BitWorkerProcess

使用 32 位工作进程布尔值

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:14
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WebApp

WebApp 对象

参数属性

类型:PSSite
默认值:None
支持通配符:False
不显示:False

参数集

S2
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WebSocketsEnabled

WebSocketsEnabled 布尔值

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

S1
Position:13
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

Int32

String

PSSite

输出

PSSite

备注

下面提供的 cmdlet 将帮助你将 Azure Web 应用更新为 DOTNETCORE $PropertiesObject = @{ “CURRENT_STACK” = “dotnetcore” } New-AzResource -PropertyObject $PropertiesObject -ResourceGroupName “Default-Web-WestUS” -- ResourceType Microsoft.Web/sites/config -ResourceName “ContosoWebApp/metadata” -ApiVersion 2018-02-01 -Force Replace the values Default-Web-WestUS of the resource group name of the webapp and ContosoWebApp with the webapp name.