Set-AzAppServicePlan

Moduł:
Az.Websites Module

Ustawia plan Azure App Service.

Składnia

S1 

Set-AzAppServicePlan
    [[-AdminSiteName] <String>]
    [[-Tier] <String>]
    [[-NumberofWorkers] <Int32>]
    [[-WorkerSize] <String>]
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-PerSiteScaling <Boolean>]
    [-AsyncScalingEnabled <Boolean>]
    [-AsJob]
    [-Tag <Hashtable>]
    [-AssignIdentity <Boolean>]
    [-UserAssignedIdentityId <String[]>]
    [-DefaultIdentity <String>]
    [-RdpEnabled <Boolean>]
    [-VirtualNetworkSubnetId <String>]
    [-InstallScript <InstallScript[]>]
    [-StorageMount <StorageMount[]>]
    [-RegistryAdapter <RegistryAdapter[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

S2 

Set-AzAppServicePlan
    [-AppServicePlan] <PSAppServicePlan>
    [-AsyncScalingEnabled <Boolean>]
    [-AsJob]
    [-DefaultProfile <IAzureContextContainer>]
    [-AssignIdentity <Boolean>]
    [-UserAssignedIdentityId <String[]>]
    [-DefaultIdentity <String>]
    [-RdpEnabled <Boolean>]
    [-VirtualNetworkSubnetId <String>]
    [-InstallScript <InstallScript[]>]
    [-StorageMount <StorageMount[]>]
    [-RegistryAdapter <RegistryAdapter[]>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Opis

Polecenie cmdlet Set-AzAppServicePlan ustawia plan Azure App Service.

Użyj parametru -AsyncScalingEnabled $true , aby zezwolić na skalowanie asynchroniczne, gdy nie ma wystarczających procesów roboczych do synchronicznego skalowania lub -AsyncScalingEnabled $false go wyłączyć. To ustawienie wymaga dedykowanego planu usługi App Service. Pomiń parametr, aby zachować istniejące ustawienie, w tym podczas przekazywania planu przez potok. Polecenie cmdlet oczekuje na ukończenie operacji; użyj -AsJob do wykonywania w tle.

W przypadku planów Managed Instance to polecenie cmdlet konfiguruje również tożsamości zarządzane, skrypty instalacji, instalacje magazynu, karty rejestru, integrację sieci wirtualnej na poziomie planu i dostęp do protokołu RDP (Remote Desktop Protocol). Ustawienia pominięte w poleceniu są zachowywane. Parametry kolekcji zastępują całą odpowiednią kolekcję; przekaż pustą tablicę, aby usunąć wszystkie wpisy. Aby dodać lub usunąć pojedynczy wpis, pobierz istniejący plan i przekaż zaktualizowaną kolekcję.

Przykłady

Przykład 1. Modyfikowanie planu usługi App Service

Set-AzAppServicePlan -ResourceGroupName "Default-Web-WestUS" -Name "ContosoASP" -PerSiteScaling $true

To polecenie ustawia opcję PerSiteScaling na wartość true w planie usługi App Service o nazwie ContosoASP, która należy do grupy zasobów o nazwie Default-Web-WestUS.

Przykład 2

Ustawia plan Azure App Service. (autogenerated)

Set-AzAppServicePlan -Name 'ContosoASP' -ResourceGroupName 'Default-Web-WestUS' -Tier Free -WorkerSize Small

Przykład 3. Zmiana planu usługi App Service na jednostkę SKU izolowanej pamięci w wersji 4

Set-AzAppServicePlan -ResourceGroupName "Default-Web-WestUS" -Name "ContosoASP" -Tier "IsolatedMV4" -WorkerSize "ExtraExtraLarge"

To polecenie zmienia plan usługi App Service w App Service Environment na jednostkę SKU zoptymalizowaną pod kątem pamięci I5MV4.

Przykład 4. Aktualizowanie tożsamości zarządzanych i wyłączanie protokołu RDP

$identityId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ContosoRG/providers/Microsoft.ManagedIdentity/userAssignedIdentities/ContosoIdentity"
Set-AzAppServicePlan -ResourceGroupName "ContosoRG" -Name "ContosoManagedPlan" -UserAssignedIdentityId $identityId -DefaultIdentity $identityId -RdpEnabled $false

To polecenie zastępuje listę tożsamości przypisanych przez użytkownika, wybiera tę tożsamość na potrzeby integracji planu i wyłącza protokół RDP. Tożsamość przypisana przez system i inne ustawienia są zachowywane, ponieważ ich parametry nie zostały określone.

Przykład 5. Usuwanie jednego skryptu instalacyjnego bez usuwania innych skryptów

$plan = Get-AzAppServicePlan -ResourceGroupName "ContosoRG" -Name "ContosoManagedPlan"
$scripts = @($plan.InstallScripts | Where-Object { $_.Name -ne "setup" })
Set-AzAppServicePlan -ResourceGroupName "ContosoRG" -Name "ContosoManagedPlan" -InstallScript $scripts

To polecenie usuwa skrypt instalacyjny i zachowuje inne skrypty w istniejącej kolejności. Jeśli konfiguracja była ostatnim skryptem, przekazanie pustej tablicy spowoduje wyczyszczenie kolekcji skryptów. Aby dodać skrypt, przekaż istniejącą kolekcję razem z nowym obiektem skryptu.

Przykład 6. Wyczyść konfigurację Managed Instance przy użyciu danych wejściowych potoku

Get-AzAppServicePlan -ResourceGroupName "ContosoRG" -Name "ContosoManagedPlan" |
    Set-AzAppServicePlan -InstallScript @() -StorageMount @() -RegistryAdapter @() -VirtualNetworkSubnetId "" -DefaultIdentity "" -AssignIdentity $false -UserAssignedIdentityId @()

To polecenie usuwa wszystkie skrypty, instalacji, karty rejestru, integrację sieci wirtualnej i tożsamości zarządzane z planu. Tożsamość domyślna jest również czyszczone. Inne właściwości, w tym to, czy plan jest planem Managed Instance, są zachowywane.

Przykład 7. Włączanie skalowania asynchronicznego podczas zwiększania liczby procesów roboczych

Set-AzAppServicePlan -ResourceGroupName "ContosoRG" -Name "ContosoASP" -NumberofWorkers 10 -AsyncScalingEnabled $true

To polecenie umożliwia asynchroniczne skalowanie w istniejącym dedykowanym planie usługi App Service i żąda dziesięciu procesów roboczych. Jeśli nie ma wystarczających procesów roboczych do synchronicznego skalowania, usługa jest skalowana asynchronicznie, a polecenie cmdlet czeka na ukończenie.

Parametry

-AcquirePolicyToken

Uzyskaj token Azure Policy automatycznie dla tej operacji zasobu.

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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AdminSiteName

Nazwa witryny administracyjnej

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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-AppServicePlan

Obiekt planu usługi App Service

Właściwości parametru

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

Zestawy parametrów

S2
Position:0
Obowiązkowy:True
Wartość z potoku:True
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ązkowy: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łącz lub wyłącz tożsamość zarządzaną przypisaną przez system planu. Pomiń ten parametr, aby zachować bieżącą tożsamość przypisaną przez system. Tożsamości przypisane przez użytkownika są zachowywane, chyba że określono również parametr -UserAssignedIdentityId .

Właściwości parametru

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

Zestawy parametrów

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

-AsyncScalingEnabled

Włączanie lub wyłączanie skalowania asynchronicznego dla dedykowanego planu usługi App Service. Ustaw wartość true, aby zezwolić na operację asynchroniczną, gdy nie ma wystarczających procesów roboczych do skalowania synchronicznego lub false, aby zezwolić tylko na skalowanie synchroniczne. Pomiń ten parametr, aby zachować bieżące ustawienie. Ten parametr może również zastąpić ustawienie planu przekazywanego przez potok i jest niezależny od parametru -AsJob.

Właściwości parametru

Typ:

Nullable<T>[Boolean]

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

Zestawy parametrów

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

-ChangeReference

Identyfikator zasobu odwołania dla tej operacji zasobu.

Właściwości parametru

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

Zestawy parametrów

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

-DefaultIdentity

Tożsamość używana domyślnie na potrzeby integracji planu. Określ [system] tożsamość przypisaną przez system lub identyfikator zasobu tożsamości przypisanej przez użytkownika skojarzonej z planem. Przekaż pusty ciąg, aby wyczyścić wartość domyślną, w tym podczas usuwania tożsamości, która została wcześniej wybrana jako domyślna. Pomiń parametr, aby zachować bieżącą wartość domyślną.

Właściwości parametru

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

Zestawy parametrów

(All)
Position:Named
Obowiązkowy: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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-InstallScript

Kompletna kolekcja skryptów instalacji dla planu Managed Instance. Każdy obiekt określa nazwę i źródło zawierające identyfikator SourceUri i typ, takie jak RemoteAzureBlob lub PlatformStorage. Przekaż pustą tablicę, aby usunąć wszystkie skrypty; Pomiń parametr, aby zachować istniejące skrypty.

Właściwości parametru

Typ:

InstallScript[]

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

Zestawy parametrów

(All)
Position:Named
Obowiązkowy: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 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:1
Obowiązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-NumberofWorkers

Liczba procesów roboczych

Właściwości parametru

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

Zestawy parametrów

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

-PerSiteScaling

Wartość logiczna skalowania w poszczególnych witrynach

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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RdpEnabled

Włącz lub wyłącz dostęp protokołu Remote Desktop (RDP) do planu Managed Instance. Przekaż wartość false, aby wyłączyć dostęp; Pomiń parametr, aby zachować bieżące ustawienie. Użyj polecenia Get-AzAppServicePlanRdpCredential , aby pobrać poświadczenia po włączeniu protokołu RDP.

Właściwości parametru

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

Zestawy parametrów

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

-RegistryAdapter

Kompletna kolekcja kart rejestru dla planu Managed Instance. Każdy obiekt określa RegistryKey, Type i KeyVaultSecretReference.SecretUri. Obsługiwane typy to Binary, String, Expand_String, Multi_String, DWord i QWord. Przekaż pustą tablicę, aby usunąć wszystkie karty; Pomiń parametr, aby zachować istniejące karty.

Właściwości parametru

Typ:

RegistryAdapter[]

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

Zestawy parametrów

(All)
Position:Named
Obowiązkowy: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ązkowy:True
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-StorageMount

Kompletna kolekcja instalacji magazynu dla planu Managed Instance. Każdy obiekt określa nazwę, typ i ścieżkę docelową. Instalacja plików AzureFiles i FileShare wymaga również poświadczenia źródłowego i może odwoływać się do poświadczeń za pomocą polecenia CredentialsKeyVaultReference.SecretUri. Instalacji LocalStorage nie wymagają źródła. Przekaż pustą tablicę, aby usunąć wszystkie instalacji; Pomiń parametr w celu zachowania istniejących instalacji.

Właściwości parametru

Typ:

StorageMount[]

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

Zestawy parametrów

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

-Tag

Tagi to pary nazw/wartości, które umożliwiają kategoryzowanie zasobów

Właściwości parametru

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

Zestawy parametrów

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

-Tier

Warstwa planu usługi App Service. Użyj izolowanego V4 dla planów I1V4 do I6V4 i IsolatedMV4 dla I1MV4 do planów zoptymalizowanych pod kątem pamięci I5MV4 w App Service Environment.

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ązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-UserAssignedIdentityId

Pełna lista identyfikatorów zasobów tożsamości zarządzanej przypisanej przez użytkownika do skojarzenia z planem. Przekaż pustą tablicę, aby usunąć wszystkie tożsamości przypisane przez użytkownika; Pomiń parametr, aby zachować bieżącą listę. Tożsamość przypisana przez system jest zachowywana, chyba że określono również parametr -AssignIdentity .

Właściwości parametru

Typ:

String[]

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

Zestawy parametrów

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

-VirtualNetworkSubnetId

Pełny identyfikator zasobu istniejącej podsieci skonfigurowanej do integracji usługi App Service, w tym delegowanie do Microsoft. Sieci Web/serwerFarms. Przekaż pusty ciąg, aby odłączyć plan od jego podsieci; Pomiń parametr, aby zachować bieżącą integrację.

Właściwości parametru

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

Zestawy parametrów

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

-WorkerSize

Rozmiar procesów roboczych do przydzielenia. W przypadku izolowanego V4 wybierz pozycję I1V4 do I6V4 za pomocą funkcji ExtraExtraExtraLarge. W obszarze IsolatedMV4 wybierz pozycję I1MV4 do I5MV4 za pomocą funkcji ExtraExtraLarge.

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ązkowy: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

PSAppServicePlan

Dane wyjściowe

PSAppServicePlan