New-ServiceFabricApplication

  • Reference
Modul:
ServiceFabric

Vytvoří aplikaci Service Fabric.

Syntaxe

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.

Typ:Uri
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTypeName

Určuje název typu aplikace Service Fabric. Rutina vytvoří aplikaci Service Fabric zadaného typu aplikace.

Typ:String
Position:1
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ApplicationTypeVersion

Určuje verzi typu aplikace Service Fabric. Rutina vytvoří aplikaci, která má zadaná verze.

Typ:String
Position:2
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky: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.

Typ:Int64
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TimeoutSec

Určuje časový limit operace v sekundách.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

System.Object