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

Set-AzureRmWebApp

修改 Azure Web 应用。

警告

AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新,建议用户从 AzureRM 迁移到 Az PowerShell 模块。

尽管 AzureRM 模块仍可运行,但不再受到维护或支持,任何继续使用的行为都由用户自行决定并自行承担风险。 有关过渡到 Az 模块的指导,请参阅我们的迁移资源

语法

Set-AzureRmWebApp
   [[-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>]
   [-ContainerImageName <String>]
   [-ContainerRegistryUrl <String>]
   [-ContainerRegistryUser <String>]
   [-ContainerRegistryPassword <SecureString>]
   [-EnableContainerContinuousDeployment <Boolean>]
   [-HostNames <String[]>]
   [-NumberOfWorkers <Int32>]
   [-AsJob]
   [-AssignIdentity <Boolean>]
   [-HttpsOnly <Boolean>]
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmWebApp
   [[-Use32BitWorkerProcess] <Boolean>]
   [[-AutoSwapSlotName] <String>]
   [-NumberOfWorkers <Int32>]
   [-AsJob]
   [-WebApp] <PSSite>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

说明

Set-AzureRmWebApp cmdlet 设置 Azure Web 应用。

示例

示例 1

PS C:\> Set-AzureRmWebApp -ResourceGroupName "Default-Web-WestUS" -Name "ContosoWebApp" -HttpLoggingEnabled $true

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

参数

-AppServicePlan

应用服务计划名称

类型:String
Position:2
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AppSettings

应用设置 HashTable

类型:Hashtable
Position:9
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AsJob

在后台运行 cmdlet

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AssignIdentity

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-AutoSwapSlotName

自动交换的目标槽名称

类型:String
Position:15
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConnectionStrings

连接字符串哈希表

类型:Hashtable
Position:10
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ContainerImageName

容器映像名称

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ContainerRegistryPassword

专用容器注册表密码

类型:SecureString
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ContainerRegistryUrl

专用容器注册表服务器 URL

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ContainerRegistryUser

专用容器注册表用户名

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultDocuments

默认文档字符串数组

类型:String[]
Position:3
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

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

类型:IAzureContextContainer
别名:AzureRmContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DetailedErrorLoggingEnabled

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

类型:Boolean
Position:8
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-EnableContainerContinuousDeployment

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HandlerMappings

处理程序映射 IList

类型:IList<T>[HandlerMapping]
Position:11
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HostNames

WebApp 主机名字符串数组

类型:String[]
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HttpLoggingEnabled

HttpLoggingEnabled Boolean

类型:Boolean
Position:7
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HttpsOnly

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

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ManagedPipelineMode

托管管道模式名称

类型:String
接受的值:Classic, Integrated
Position:12
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

WebApp 名称

类型:String
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-NetFrameworkVersion

Net Framework 版本

类型:String
Position:4
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-NumberOfWorkers

要分配的辅助角色数

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

-PhpVersion

Php 版本

类型:String
Position:5
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RequestTracingEnabled

请求跟踪已启用

类型:Boolean
Position:6
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

资源组名称

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Use32BitWorkerProcess

使用 32 位工作进程布尔值

类型:Boolean
Position:14
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WebApp

WebApp 对象

类型:PSSite
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-WebSocketsEnabled

WebSocketsEnabled Boolean

类型:Boolean
Position:13
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Int32

参数:NumberOfWorkers (ByValue)

String

Site

参数:WebApp (ByValue)

输出

Site