Set-AzWebApp
Modyfikuje aplikację internetową platformy Azure.
Składnia
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>]
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. (automatycznie wygenerowane)
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.
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-AppServicePlan
Nazwa planu usługi App Service
Typ: | String |
Position: | 2 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | 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.
Typ: | Hashtable |
Position: | 9 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-AsJob
Uruchamianie polecenia cmdlet w tle
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-AssignIdentity
Włączanie/wyłączanie tożsamości usługi zarządzanej w istniejącej aplikacji internetowej lub aplikacji funkcji platformy Azure
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-AutoSwapSlotName
Nazwa miejsca docelowego dla zamiany automatycznej
Typ: | String |
Position: | 15 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-AzureStoragePath
Usługa Azure Storage do zainstalowania wewnątrz aplikacji internetowej dla kontenera. Użyj New-AzWebAppAzureStoragePath, aby go utworzyć
Typ: | WebAppAzureStoragePath[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ConnectionStrings
Tabela skrótów parametrów połączenia
Typ: | Hashtable |
Position: | 10 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ContainerImageName
Nazwa obrazu kontenera
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ContainerRegistryPassword
Hasło prywatnego rejestru kontenerów
Typ: | SecureString |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ContainerRegistryUrl
Adres URL prywatnego serwera usługi Container Registry
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ContainerRegistryUser
Nazwa użytkownika usługi Private Container Registry
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DefaultDocuments
Domyślna tablica ciągów dokumentów
Typ: | String[] |
Position: | 3 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliasy: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-DetailedErrorLoggingEnabled
Szczegółowe rejestrowanie błędów włączone logiczną
Typ: | Boolean |
Position: | 8 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-EnableContainerContinuousDeployment
Włącza/wyłącza element webhook ciągłego wdrażania kontenera
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-FtpsState
Ustaw wartość stanu ftps dla aplikacji. Dozwolone wartości [AllAllowed | Wyłączone | FTPsOnly].
Typ: | String |
Dopuszczalne wartości: | AllAllowed, Disabled, FtpsOnly |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-HandlerMappings
Lista IList mapowań programu obsługi
Typ: | IList<T>[HandlerMapping] |
Position: | 11 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-HostNames
Tablica ciągów HostNames usługi WebApp
Typ: | String[] |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-HttpLoggingEnabled
HttpLoggingEnabled wartość logiczna
Typ: | Boolean |
Position: | 7 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-HttpsOnly
Włączanie/wyłączanie przekierowywania całego ruchu do protokołu HTTPS w istniejącej aplikacji internetowej lub aplikacji funkcji platformy Azure
Typ: | Boolean |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ManagedPipelineMode
Nazwa trybu potoku zarządzanego
Typ: | String |
Dopuszczalne wartości: | Classic, Integrated |
Position: | 12 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-MinTlsVersion
Minimalna wersja protokołu TLS wymagana dla żądań SSL. Dozwolone wartości [1.0 | 1.1 | 1.2].
Typ: | String |
Dopuszczalne wartości: | 1.0, 1.1, 1.2 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Name
Nazwa aplikacji internetowej
Typ: | String |
Position: | 1 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-NetFrameworkVersion
Wersja programu Net Framework
Typ: | String |
Position: | 4 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-NumberOfWorkers
Liczba pracowników do przydzielenia
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-PhpVersion
Wersja języka Php
Typ: | String |
Position: | 5 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-RequestTracingEnabled
Włączone śledzenie żądań
Typ: | Boolean |
Position: | 6 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Nazwa grupy zasobów
Typ: | String |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-Use32BitWorkerProcess
Używanie 32-bitowego elementu logicznego procesu roboczego
Typ: | Boolean |
Position: | 14 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-WebApp
Obiekt WebApp
Typ: | PSSite |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-WebSocketsEnabled
WebSocketsEnabled wartość logiczna
Typ: | Boolean |
Position: | 13 |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
Dane wyjściowe
Uwagi
Poniższe podane polecenie cmdlet pomoże Ci zaktualizować aplikację internetową platformy Azure do 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 Zastąp wartości Default-Web-WestUS
nazwą grupy zasobów aplikacji internetowej i ContosoWebApp
nazwą aplikacji internetowej.