New-ServiceFabricApplication
Vytvoří aplikaci Service Fabric.
Syntax
New-ServiceFabricApplication
[-ApplicationName] <Uri>
[-ApplicationTypeName] <String>
[-ApplicationTypeVersion] <String>
[-ApplicationParameter <Hashtable>]
[-MaximumNodes <Int64>]
[-MinimumNodes <Int64>]
[-Metrics <String[]>]
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
Rutina New-ServiceFabricApplication vytvoří aplikaci Service Fabric registrovaného typu aplikace. K registraci typu aplikace použijte rutinu Register-ServiceFabricApplicationType .
Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster .
Příklady
Příklad 1: Vytvoření aplikace
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0"Tento příkaz vytvoří aplikaci typu PersistentToDoListApp. Aplikace je verze 1.0. Typ a verze aplikace pocházejí z manifestu aplikace v balíčku aplikace, který byl použit při registraci aplikace pomocí rutiny Register-ServiceFabricApplicationType .
Příklad 2: Vytvoření aplikace přepsáním výchozích hodnot parametrů v manifestu aplikace
PS C:\> New-ServiceFabricApplication -ApplicationName fabric:/myapp/persistenttodolist -ApplicationTypeName "PersistentToDoListApp" -ApplicationTypeVersion "1.0" -ApplicationParameter @{CustomParameter1='MyValue'; CustomParameter2='MyValue'}Tento příkaz vytvoří aplikaci typu PersistentToDoListApp a verze 1.0 s přepsánými hodnotami pro parametry CustomParameter1 a CustomParameter2. Tyto názvy parametrů musí existovat v manifestu aplikace balíčku aplikace, který byl použit při registraci aplikace pomocí rutiny Register-ServiceFabricApplicationType .
Parametry
-ApplicationName
Určuje identifikátor URI (Uniform Resource Identifier) aplikace Service Fabric. Rutina vytvoří aplikaci Service Fabric s zadaným názvem.
| Type: | Uri |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationParameter
Určuje přepsání parametrů aplikace definovaných v manifestu aplikace jako páry klíč/hodnota. Rutina vytvoří aplikaci Service Fabric typu aplikace a pro tyto parametry použije přepsáné hodnoty. V manifestu aplikace musí existovat parametry, které jsou zde přepsány.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeName
Určuje název typu aplikace Service Fabric. Rutina vytvoří aplikaci Service Fabric zadaného typu aplikace.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ApplicationTypeVersion
Určuje verzi typu aplikace Service Fabric. Rutina vytvoří aplikaci, která má zadaná verze.
| Type: | String |
| Position: | 2 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumNodes
Určuje maximální počet uzlů, na které se má aplikace umístit. Hodnota tohoto parametru musí být nezáporné celé číslo. Výchozí hodnota je 0, což označuje, že aplikaci lze umístit na libovolný počet uzlů v clusteru.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Metrics
Určuje pole metrik. Tyto metriky používají cluster Service Fabric Resource Manager ke správě prostředků v clusteru. Další informace o metrikách a správě prostředků ve službě Service Fabric najdete v tématu Úvod ke clusteru Service Fabric Resource Manager. Každá metrika může následovat podle vzoru MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity nebo může zadat MetricName a použít názvy parametrů NodeReservationCapacity, MaximumNodeCapacity nebo TotalApplicationCapacity následované hodnotou parametru a oddělenou dvojtečku. Každý pár parametru name:value se může zobrazit najednou.
- MetricName. Určuje název metriky.
- NodeReservationCapacity. Určuje množství zatížení metriky, které je vyhrazeno na uzlech s instancemi této aplikace. Pokud je zadána minimální uzly , je produkt těchto hodnot kapacitou vyhrazenou v clusteru pro aplikaci.
- MaximumNodeCapacity. Určuje maximální zatížení instance této aplikace na jednom uzlu. I když je kapacita uzlu větší než tato hodnota, Service Fabric omezuje celkové zatížení podřízených replik aplikace na tuto hodnotu.
- TotalApplicationCapacity. Určuje celkovou kapacitu aplikace v clusteru. Service Fabric se pokusí omezit součet zatížení podřízených replik aplikace na tuto hodnotu.
Při vytváření aplikace service Fabric provede následující ověření a příkaz selže, pokud neprojde:
NodeReservationCapacity nesmí být větší než MaximumNodeCapacity.
Pokud je zadán parametr MinimumNode i metrika NodeReservationCapacity, nesmí být produkt MinimumNode a NodeReservationCapacity větší než TotalApplicationCapacity. Další informace najdete v tématu Metriky aplikací, zatížení a kapacita.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumNodes
Určuje minimální počet uzlů, ve kterých bude Service Fabric rezervovat kapacitu pro tuto aplikaci, to neznamená, že aplikace zaručuje, že bude mít repliky na všech těchto uzlech. Hodnota tohoto parametru musí být nezáporné celé číslo. Výchozí hodnota pro tuto hodnotu je nula, což znamená, že pro aplikaci není vyhrazena žádná kapacita.
| Type: | Int64 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutSec
Určuje časový limit operace v sekundách.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Vstupy
None
Výstupy
System.Object