Update-ServiceFabricApplication

  • Referens
Modul:
ServiceFabric

Uppdaterar eller tar bort programkapaciteten.

Syntax

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

Description

Update-ServiceFabricApplication cmdlet uppdaterar eller tar bort programkapaciteten för ett program som redan har skapats.

Programkapacitet definierar maximala/minsta noder för ett program samt kapacitet per nod för dess mått.

Exempel

Exempel 1: Uppdatera MaximumNodes och mått

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

Det här kommandot uppdaterar programinfrastrukturen:/MyApp så att högst sex noder används. Varje nod har en reserverad belastning på två enheter och en maximal belastning på 12 enheter för CPU-måttet på varje nod. Den totala programkapaciteten är 16 enheter för CPU-måttet. Värdet för MinimumNodes förblir oförändrat.

Exempel 2: Uppdatera MaximumNodes och återställa mått

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

Det här kommandot uppdaterar programinfrastrukturen:/MyApp så att den använder högst sex noder och tar bort kapaciteter för alla mått. Om det finns tidigare definierade kapaciteter rensas de efter det här kommandot. Värdet för MinimumNodes är oförändrat.

Exempel 3: Uppdatera alla programkapacitetsparametrar

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

Det här kommandot uppdaterar programinfrastrukturen:/MyApp så att högst sex noder används. Varje nod har en reserverad belastning på två enheter och en maximal belastning på 12 enheter för måttprocessorn på varje nod. Den totala programkapaciteten är 16 enheter för CPU-måttet. Värdet för minsta noder uppdateras till 2, så att Service Fabric reserverar en total kapacitet på fyra enheter för CPU-måttet i klustret.

Exempel 4: Ta bort alla programkapacitetsparametrar

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

Det här kommandot uppdaterar programinfrastrukturen:/MyApp så att inga parametrar för programkapacitet har definierats. Om MyApp hade några tidigare angivna kapacitetsparametrar rensar den här åtgärden dem.

Parametrar

-ApplicationName

Anger namnet på programmet som ska uppdateras.

Typ:Uri
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MaximumNodes

Anger det maximala antalet noder som ett program ska placeras på. Värdet för den här parametern måste vara ett heltal som inte är negativt. Standardvärdet är 0, vilket anger att programmet kan placeras på valfritt antal noder i klustret.

Om du inte anger den här parametern använder programmet det befintliga maximala antalet noder som angetts för programmet.

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Metrics

Anger en matris med mått. Dessa mått används av Service Fabric Cluster Resource Manager för att hantera resurser i klustret. Mer information om mått och resurshantering i Service Fabric finns i Service Fabric Cluster Resource Manager Introduction. Varje mått kan följa mönstret MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity eller ange MetricName och använda parameternamnen NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity följt av ett parametervärde avgränsat med ett kolon. Varje parameter namn:värde par kan visas högst en gång.

  • MetricName. Anger måttets namn.
  • NodeReservationCapacity. Anger mängden måttbelastning som är reserverad för noder som har instanser av det här programmet. Om MinimumNodes anges är produkten av dessa värden den kapacitet som är reserverad i klustret för programmet.
  • MaximumNodeCapacity. Anger den maximala belastningen för en instans av det här programmet på en enda nod. Även om nodens kapacitet är större än det här värdet begränsar Service Fabric den totala belastningen för programmets underordnade repliker till det här värdet.
  • TotalApplicationCapacity. Anger den totala kapaciteten för programmet i klustret. Service Fabric försöker begränsa summan av belastningarna för programmets underordnade repliker till det här värdet.

När kapaciteten uppdateras utför Service Fabric följande valideringar och misslyckas med kommandot om de inte godkänns:

  • NodeReservationCapacity får inte vara mer än MaximumNodeCapacity.
  • Om både parametern MinimumNodes och Måttet NodeReservationCapacity anges får produkten av MinimumNodes och NodeReservationCapacity inte vara mer än TotalApplicationCapacity.
Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-MinimumNodes

Anger antalet noder i ett kluster där kapaciteten är reserverad för det här programmet. Det innebär inte att programmet garanteras ha repliker på alla dessa noder. Värdet för den här parametern måste vara ett heltal som inte är negativt. Standardvärdet för detta är noll, vilket innebär att ingen kapacitet är reserverad för programmet.

Om MinimumNodes är inställt på 0 reserveras ingen kapacitet.

Typ:Int64
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RemoveApplicationCapacity

Anger att den här åtgärden rensar alla parametrar som är relaterade till programmets programkapacitet. Om du anger den här parametern kan du inte ange parametern Mått för att uppdatera programkapaciteten.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-TimeoutSec

Anger tidsgränsen i sekunder för åtgärden.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

None

Utdata

System.Object