Update-ServiceFabricApplication

Reference

Modul:: ServiceFabric

Aktualizace nebo odebere kapacitu aplikace.

Syntax

Update-ServiceFabricApplication
      [-ApplicationName] <Uri>
      [-RemoveApplicationCapacity]
      [-MaximumNodes <Int64>]
      [-MinimumNodes <Int64>]
      [-Metrics <String[]>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]

Description

Rutina Update-ServiceFabricApplication aktualizuje nebo odebere kapacitu aplikace pro již vytvořenou aplikaci.

Kapacita aplikace definuje maximální/minimální uzly pro aplikaci a také kapacitu pro jednotlivé uzly pro své metriky.

Příklady

Příklad 1: Aktualizace maximálních uzlů a metrik

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @("CPU,2,12,16")

Tento příkaz aktualizuje prostředky infrastruktury aplikace:/MyApp tak, aby používal maximálně šest uzlů. Každý uzel má rezervované zatížení dvou jednotek a maximální zatížení 12 jednotek pro metriku procesoru na každém uzlu. Celková kapacita aplikace je 16 jednotek pro metriku procesoru. Hodnota minimálních uzlů zůstává beze změny.

Příklad 2: Aktualizace maximálních uzlů a resetování metrik

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MaximumNodes 6 -Metrics @()

Tento příkaz aktualizuje prostředky infrastruktury aplikace:/MyApp tak, aby používal maximálně šest uzlů a odebral kapacity pro všechny metriky. Pokud existují nějaké dříve definované kapacity, vymažou se po tomto příkazu. Hodnota minimálních uzlů se nezmění.

Příklad 3: Aktualizace všech parametrů kapacity aplikace

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -MinumumNodes 2 -MaximumNodes 6 -Metrics @("CPU,2,12,16")

Tento příkaz aktualizuje prostředky infrastruktury aplikace:/MyApp tak, aby používal maximálně šest uzlů. Každý uzel má rezervované zatížení dvou jednotek a maximální zatížení 12 jednotek pro procesor metriky na každém uzlu. Celková kapacita aplikace je 16 jednotek pro metriku procesoru. Hodnota minimálních uzlů se aktualizuje na 2, aby Service Fabric rezervuje celkovou kapacitu čtyř jednotek pro metriku procesoru v clusteru.

Příklad 4: Odebrání všech parametrů kapacity aplikace

PS C:\> Update-ServiceFabricApplication fabric:/MyApp -RemoveApplicationCapacity

Tento příkaz aktualizuje prostředky infrastruktury aplikace:/MyApp tak, aby neměl definované parametry kapacity aplikace. Pokud má aplikace MyApp nějaké dříve nastavené parametry kapacity, tato operace je vymaže.

Parametry

-ApplicationName

Určuje název aplikace, která se má aktualizovat.

Type:	Uri
Position:	0
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.

Pokud tento parametr nezadáte, aplikace použije existující maximální počet uzlů nastavených pro aplikaci.

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, TotalApplicationCapacity následované hodnotou parametru 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 aktualizaci kapacity 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.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MinimumNodes

Určuje počet uzlů v clusteru, na kterém je kapacita vyhrazená 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.

Pokud je minimum uzlů nastaveno na hodnotu 0, není vyhrazena žádná kapacita.

Type:	Int64
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveApplicationCapacity

Označuje, že tato operace vymaže všechny parametry související s kapacitou aplikace pro aplikaci. Pokud zadáte tento parametr, nelze zadat parametr Metriky pro aktualizaci kapacity aplikace.

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