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

Set-AzWebApp

模块:

Az.Websites

修改 Azure Web 应用。

语法

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>]
   [-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>]
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzWebApp
   [[-Use32BitWorkerProcess] <Boolean>]
   [[-AutoSwapSlotName] <String>]
   [-NumberOfWorkers <Int32>]
   [-AsJob]
   [-WebApp] <PSSite>
   [-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 应用。 （自动生成）

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
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AppServicePlan

应用服务计划名称

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

-AppSettings

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

类型:	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

-AzureStoragePath

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

类型:	WebAppAzureStoragePath[]
Position:	Named
默认值:	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
别名:	AzContext, 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

-FtpsState

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

类型:	String
接受的值:	AllAllowed, Disabled, FtpsOnly
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

-MinTlsVersion

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

类型:	String
接受的值:	1.0, 1.1, 1.2
Position:	Named
默认值:	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

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 将 Default-Web-WestUS 的值替换为 webapp 的资源组名称，ContosoWebApp 替换为 webapp 名称。

相关链接

• Get-AzWebApp
• New-AzWebApp
• Remove-AzWebApp
• Restart-AzWebApp
• Start-AzWebApp
• Stop-AzWebApp
• New-AzResource