Udostępnij przez


Set-AzWebApp

Modyfikuje aplikację internetową platformy Azure.

Składnia

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

Opis

Polecenie cmdlet Set-AzWebApp ustawia aplikację internetową platformy Azure.

Przykłady

Przykład 1

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

To polecenie zmienia plan usługi appservice skojarzony z aplikacją internetową ContosoWebApp skojarzona z grupą zasobów Default-Web-WestUS. Skorzystaj z linku, aby dowiedzieć się więcej na temat zmiany skojarzonego z nim planu usługi appservice i ograniczeń. https://learn.microsoft.com/azure/app-service/app-service-plan-manage#move-an-app-to-another-app-service-plan

Przykład 2

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

To polecenie ustawia wartość HttpLoggingEnabled na wartość true dla aplikacji internetowej ContosoWebApp skojarzonej z grupą zasobów Default-Web-WestUS

Przykład 3

Modyfikuje aplikację internetową platformy Azure. (autogenerated)

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

Przykład 4

Poniższy przykład tworzy parametry połączenia o nazwie myConnectionString dla aplikacji internetowej ContosoWebApp. Spowoduje to zastąpienie wszystkich istniejących parametrów połączenia dla aplikacji internetowej ContosoWebApp.

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

Przykład 5

Włączanie usługi Application Insights dla aplikacji internetowej

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

Parametry

-AlwaysOn

Upewnij się, że aplikacja internetowa jest ładowana przez cały czas, a nie zwalniana po bezczynności.

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AppServicePlan

Nazwa planu usługi App Service

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:2
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AppSettings

Tabela skrótów ustawień aplikacji. Istniejące ustawienia aplikacji zostaną zastąpione, usuwając wszystkie ustawienia, które nie zostały podane.

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:9
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AsJob

Uruchamianie polecenia cmdlet w tle

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AssignIdentity

Włączanie/wyłączanie tożsamości usługi zarządzanej w istniejącej aplikacji internetowej lub aplikacji funkcji platformy Azure

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AutoSwapSlotName

Nazwa miejsca docelowego dla zamiany automatycznej

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:15
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AzureStoragePath

Usługa Azure Storage do zainstalowania wewnątrz aplikacji internetowej dla kontenera. Użyj New-AzWebAppAzureStoragePath, aby go utworzyć

Właściwości parametru

Typ:

WebAppAzureStoragePath[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ConnectionStrings

Tabela skrótów parametrów połączenia

Właściwości parametru

Typ:Hashtable
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:10
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ContainerImageName

Nazwa obrazu kontenera

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ContainerRegistryPassword

Hasło prywatnego rejestru kontenerów

Właściwości parametru

Typ:SecureString
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ContainerRegistryUrl

Adres URL prywatnego serwera usługi Container Registry

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ContainerRegistryUser

Nazwa użytkownika usługi Private Container Registry

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultDocuments

Domyślna tablica ciągów dokumentów

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:3
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Właściwości parametru

Typ:IAzureContextContainer
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False
Aliasy:AzContext, AzureRmContext, AzureCredential

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-DetailedErrorLoggingEnabled

Szczegółowe rejestrowanie błędów włączone logiczną

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:8
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-EnableContainerContinuousDeployment

Włącza/wyłącza element webhook ciągłego wdrażania kontenera

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-FtpsState

Ustaw wartość stanu ftps dla aplikacji. Dozwolone wartości [AllAllowed | Wyłączone | FTPsOnly].

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:AllAllowed, Disabled, FtpsOnly
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HandlerMappings

Lista IList mapowań programu obsługi

Właściwości parametru

Typ:

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

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:11
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HostNames

Tablica ciągów HostNames usługi WebApp

Właściwości parametru

Typ:

String[]

Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HttpLoggingEnabled

HttpLoggingEnabled wartość logiczna

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:7
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-HttpsOnly

Włączanie/wyłączanie przekierowywania całego ruchu do protokołu HTTPS w istniejącej aplikacji internetowej lub aplikacji funkcji platformy Azure

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ManagedPipelineMode

Nazwa trybu potoku zarządzanego

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:Classic, Integrated
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:12
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MinTlsVersion

Minimalna wersja protokołu TLS wymagana dla żądań SSL. Dozwolone wartości [1.0 | 1.1 | 1.2].

Właściwości parametru

Typ:String
Domyślna wartość:None
Dopuszczalne wartości:1.0, 1.1, 1.2
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:Named
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Name

Nazwa aplikacji internetowej

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:1
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:True
Wartość z pozostałych argumentów:False

-NetFrameworkVersion

Wersja programu Net Framework

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:4
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-NumberOfWorkers

Liczba pracowników do przydzielenia

Właściwości parametru

Typ:Int32
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowe:False
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PhpVersion

Wersja języka Php

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:5
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RequestTracingEnabled

Włączone śledzenie żądań

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:6
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ResourceGroupName

Nazwa grupy zasobów

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:0
Obowiązkowe:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-Use32BitWorkerProcess

Używanie 32-bitowego elementu logicznego procesu roboczego

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:14
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WebApp

Obiekt WebApp

Właściwości parametru

Typ:PSSite
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S2
Position:0
Obowiązkowe:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WebSocketsEnabled

WebSocketsEnabled wartość logiczna

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

S1
Position:13
Obowiązkowe:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

Int32

String

PSSite

Dane wyjściowe

PSSite

Uwagi

Poniższe podane polecenie cmdlet pomoże Ci zaktualizować aplikację internetową platformy Azure do $PropertiesObject DOTNETCORE = @{ "CURRENT_STACK" = "dotnetcore" } New-AzResource -PropertyObject $PropertiesObject -ResourceGroupName "Default-Web-WestUS" -ResourceType Microsoft.Web/sites/config -ResourceName "ContosoWebApp/metadata" -ApiVersion 2018-02-01 -Force Zastąp wartości pola Default-Web-WestUS nazwą grupy zasobów aplikacji internetowej i ContosoWebApp nazwą aplikacji internetowej.