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>]

Description

Set-AzWebApp Cmdlet 會設定 Azure Web 應用程式。

範例

範例 1

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

此命令會變更與資源群組 Default-Web-WestUS 相關聯的 Web App ContosoWebApp 相關聯的 appservice 方案。使用連結深入瞭解如何變更 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

下列範例會建立名為 myConnectionString for Web App ContosoWebApp 的連接字串。這會取代 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

App Service 方案名稱

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

-AzureStoragePath

Azure 儲存體在容器的 Web 應用程式內掛接。使用 New-AzWebAppAzureStoragePath 建立它

類型:	WebAppAzureStoragePath[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ConnectionStrings

連接字串HashTable

類型:	Hashtable
Position:	10
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ContainerImageName

容器映像名稱

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ContainerRegistryPassword

私人容器登錄密碼

類型:	SecureString
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-ContainerRegistryUrl

Private Container Registry Server 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 HostNames 字串陣列

類型:	String[]
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HttpLoggingEnabled

HttpLoggingEnabled 布爾值

類型:	Boolean
Position:	7
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-HttpsOnly

啟用/停用將所有流量重新導向至現有 Azure webapp 或 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
Position:	13
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

Int32

String

PSSite

輸出