New-AzAppServicePlan

Tworzy plan Azure App Service w danej lokalizacji geograficznej.

Składnia

S1

New-AzAppServicePlan
    [-Location] <String>
    [[-Tier] <String>]
    [[-NumberofWorkers] <Int32>]
    [[-WorkerSize] <String>]
    [[-AseName] <String>]
    [[-AseResourceGroupName] <String>]
    [[-AseResourceId] <String>]
    [-ResourceGroupName] <String>
    [-Name] <String>
    [-PerSiteScaling <Boolean>]
    [-AsyncScalingEnabled <Boolean>]
    [-HyperV]
    [-AsJob]
    [-Tag <Hashtable>]
    [-Linux]
    [-ManagedInstance]
    [-AssignIdentity <Boolean>]
    [-UserAssignedIdentityId <String[]>]
    [-DefaultIdentity <String>]
    [-RdpEnabled <Boolean>]
    [-VirtualNetworkSubnetId <String>]
    [-InstallScript <InstallScript[]>]
    [-StorageMount <StorageMount[]>]
    [-RegistryAdapter <RegistryAdapter[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

S2

New-AzAppServicePlan
    [-Location] <String>
    [[-Tier] <String>]
    [[-NumberofWorkers] <Int32>]
    [[-WorkerSize] <String>]
    [[-AseName] <String>]
    [[-AseResourceGroupName] <String>]
    [[-AseResourceId] <String>]
    [-AppServicePlan] <PSAppServicePlan>
    [-PerSiteScaling <Boolean>]
    [-AsyncScalingEnabled <Boolean>]
    [-AsJob]
    [-AssignIdentity <Boolean>]
    [-UserAssignedIdentityId <String[]>]
    [-DefaultIdentity <String>]
    [-RdpEnabled <Boolean>]
    [-VirtualNetworkSubnetId <String>]
    [-InstallScript <InstallScript[]>]
    [-StorageMount <StorageMount[]>]
    [-RegistryAdapter <RegistryAdapter[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-AcquirePolicyToken]
    [-ChangeReference <String>]
    [<CommonParameters>]

Opis

Polecenie cmdlet New-AzAppServicePlan tworzy plan Azure App Service w danej lokalizacji geograficznej z określoną warstwą, rozmiarem procesu roboczego i liczbą procesów roboczych.

Użyj -AsyncScalingEnabled $true , aby zezwolić na skalowanie asynchroniczne, gdy nie ma wystarczających procesów roboczych do synchronicznego skalowania. To ustawienie wymaga dedykowanego planu usługi App Service i nie uruchamia polecenia cmdlet w tle; użyj -AsJob do wykonywania w tle.

Użyj -ManagedInstance, aby utworzyć plan Managed Instance dla aplikacji Windows, które wymagają dostosowania systemu operacyjnego. Skonfiguruj tożsamości zarządzane, skrypty instalacji, instalacje magazynu, karty rejestru, integrację sieci wirtualnej na poziomie planu i dostęp protokołu RDP (Remote Desktop Protocol) z odpowiednimi parametrami. Managed Instance plany nie mogą używać -Linux lub -HyperV.

Przykłady

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

New-AzAppServicePlan -ResourceGroupName "Default-Web-WestUS" -Name "ContosoASP" -Location "West US" -Tier "Basic" -NumberofWorkers 2 -WorkerSize "Small"

To polecenie tworzy plan usługi App Service o nazwie ContosoASP w grupie zasobów o nazwie Default-Web-WestUS w lokalizacji geograficznej Zachodnie stany USA. Polecenie określa warstwę Podstawową i przydziela dwa małe procesy robocze.

Przykład 2. Tworzenie izolowanego planu usługi App Service w wersji 4

New-AzAppServicePlan -ResourceGroupName "Default-Web-WestUS" -Name "ContosoIsolatedASP" -Location "West US" -Tier "IsolatedV4" -WorkerSize "ExtraExtraExtraLarge" -AseName "ContosoAse"

To polecenie tworzy plan usługi App Service I6V4 w App Service Environment o nazwie ContosoAse. Użyj rozmiarów procesów roboczych Small through ExtraExtraExtraLarge, aby wybrać od I1V4 do I6V4.

Przykład 3: Tworzenie planu usługi App Service izolowanego zoptymalizowanego pod kątem pamięci w wersji 4

New-AzAppServicePlan -ResourceGroupName "Default-Web-WestUS" -Name "ContosoMemoryOptimizedASP" -Location "West US" -Tier "IsolatedMV4" -WorkerSize "ExtraExtraLarge" -AseName "ContosoAse"

To polecenie tworzy plan usługi App Service zoptymalizowany pod kątem pamięci I5MV4 w App Service Environment o nazwie ContosoAse. Użyj rozmiarów procesów roboczych Small through ExtraExtraLarge, aby wybrać I1MV4 do I5MV4.

Przykład 4. Tworzenie planu Managed Instance przy użyciu tożsamości i sieci

$subnetId = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ContosoRG/providers/Microsoft.Network/virtualNetworks/ContosoVnet/subnets/ContosoSubnet"
New-AzAppServicePlan -ResourceGroupName "ContosoRG" -Name "ContosoManagedPlan" -Location "eastus" -Tier "PremiumV4" -WorkerSize "Small" -NumberofWorkers 1 -ManagedInstance -AssignIdentity $true -DefaultIdentity "[system]" -RdpEnabled $true -VirtualNetworkSubnetId $subnetId

To polecenie tworzy plan Managed Instance, włącza tożsamość zarządzaną przypisaną przez system i dostęp RDP oraz integruje plan z istniejącą podsiecią. Podsieć musi spełniać wymagania dotyczące integracji sieci wirtualnej usługi App Service, w tym delegowanie do Microsoft. Sieci Web/serwerFarms. Tożsamość przypisana przez system jest domyślnie używana na potrzeby integracji planu.

Przykład 5. Konfigurowanie skryptów, instalacji magazynu i kart rejestru

$script = @{
    Name = "setup"
    Source = @{
        # The ZIP package must contain Install.ps1 at its root.
        SourceUri = "https://contosostorage.blob.core.windows.net/scripts/setup.zip"
        Type = "RemoteAzureBlob"
    }
}
$mount = @{
    Name = "data"
    Type = "AzureFiles"
    Source = "\\contosostorage.file.core.windows.net\data"
    DestinationPath = "D:\data"
    CredentialsKeyVaultReference = @{
        SecretUri = "https://contosovault.vault.azure.net/secrets/storage-credentials"
    }
}
$adapter = @{
    RegistryKey = "HKEY_LOCAL_MACHINE\Software\Contoso\Setting"
    Type = "String"
    KeyVaultSecretReference = @{
        SecretUri = "https://contosovault.vault.azure.net/secrets/registry-setting"
    }
}
New-AzAppServicePlan -ResourceGroupName "ContosoRG" -Name "ContosoManagedPlan" -Location "eastus" -Tier "PremiumV4" -ManagedInstance -AssignIdentity $true -DefaultIdentity "[system]" -InstallScript $script -StorageMount $mount -RegistryAdapter $adapter

To polecenie konfiguruje skrypt instalacji, instalację Azure Files i kartę rejestru podczas tworzenia planu. Tożsamość planu musi mieć uprawnienia dostępu do skryptu i odwołanych wpisów tajnych Key Vault. Wartości tabeli skrótu są konwertowane na odpowiednie obiekty konfiguracji.

Przykład 6. Tworzenie planu usługi App Service z włączonym skalowaniem asynchronicznym

New-AzAppServicePlan -ResourceGroupName "ContosoRG" -Name "ContosoASP" -Location "East US" -Tier "PremiumV3" -WorkerSize "Small" -NumberofWorkers 10 -AsyncScalingEnabled $true

To polecenie tworzy dedykowany plan usługi App Service, który może być skalowany asynchronicznie, gdy nie ma wystarczających procesów roboczych do wykonania żądania synchronicznie. Polecenie cmdlet czeka na ukończenie operacji przed zwróceniem planu.

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

-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

-AseName

nazwa App Service Environment

Właściwości parametru

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

Zestawy parametrów

(All)
Position:6
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

-AseResourceGroupName

nazwa grupy zasobó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

(All)
Position:7
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

-AseResourceId

Identyfikator zasobu App Service Environment

Właściwości parametru

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

Zestawy parametrów

(All)
Position:8
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

-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 w planie usługi App Service. Tożsamości przypisane przez użytkownika są konfigurowane oddzielnie za pomocą parametru -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 użyć domyślnej usługi. To ustawienie jest niezależne 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] , aby użyć tożsamości przypisanej przez system planu lub identyfikatora zasobu tożsamości przypisanej przez użytkownika skojarzonej z planem. Przekaż pusty ciąg, aby wyczyścić tożsamość 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

-HyperV

Określ to, plan usługi App Service uruchomi kontenery Windows

Właściwości parametru

Typ:SwitchParameter
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

-InstallScript

Skrypty instalacji do skonfigurowania dla planu Managed Instance. Każdy obiekt określa nazwę i źródło zawierające identyfikator SourceUri i Typ. Obsługiwane typy źródeł to RemoteAzureBlob i PlatformStorage.

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

-Linux

Określ to, plan usługi App Service uruchomi kontenery systemu Linux

Właściwości parametru

Typ:SwitchParameter
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

-Location

Location

Właściwości parametru

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

Zestawy parametrów

(All)
Position:2
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

-ManagedInstance

Utwórz plan usługi App Service Managed Instance, włączając tryb niestandardowy. Użyj tej opcji dla aplikacji Windows, które wymagają skryptów instalacji, dostosowywania rejestru lub instalacji magazynu na poziomie planu. Tej opcji nie można połączyć z -Linux lub -HyperV.

Właściwości parametru

Typ:SwitchParameter
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

-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ść:1
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
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

Określa, czy włączyć skalowanie 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

(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

-RdpEnabled

Włącz lub wyłącz dostęp protokołu Remote Desktop (RDP) do planu Managed Instance. Użyj polecenia Get-AzAppServicePlanRdpCredential , aby pobrać poświadczenia i polecenie Get-AzAppServicePlanManagedInstance w celu pobrania adresów IP 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: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

Karty rejestru do skonfigurowania dla planu Managed Instance. Każdy obiekt określa wartość RegistryKey, Type i KeyVaultSecretReference zawierającą identyfikator SecretUri wartości rejestru. Obsługiwane typy to Binary, String, Expand_String, Multi_String, DWord i QWord.

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

Instalacja magazynu do skonfigurowania dla planu Managed Instance. Każdy obiekt określa nazwę, typ i ścieżkę docelową. Instalacja plików AzureFiles i FileShare również wymaga źródła; użyj credentialsKeyVaultReference.SecretUri dla poświadczeń przechowywanych w Key Vault. Instalacji LocalStorage nie wymagają źródła.

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ść:Free
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
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

Identyfikatory zasobów tożsamości zarządzanych przypisanych przez użytkownika do skojarzenia z planem usługi App Service. Użyj opcji -DefaultIdentity , aby wybrać tożsamość używaną domyślnie na potrzeby integracji planu.

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 używanej do integracji sieci wirtualnej na poziomie planu. Podsieć musi być skonfigurowana na potrzeby integracji usługi App Service, w tym delegowania do Microsoft. Sieci Web/serwerFarms.

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ść:Small
Dopuszczalne wartości:ExtraSmall, Small, Medium, Large, ExtraLarge, ExtraExtraLarge, ExtraExtraExtraLarge
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
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