Dela via

Update-ServiceFabricApplication

  • Referens
Modul:
ServiceFabric

Uppdateringar eller tar bort programkapacitet.

Syntax

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

Description

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

Programkapacitet definierar de högsta/lägsta noderna för ett program samt kapacitet per nod för dess mått.

Exempel

Exempel 1: Uppdatera maximumnoder 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äll 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.

Type:Uri
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-Metrics

Anger en matris med mått. Dessa mått används av Service Fabric-kluster Resource Manager för att hantera resurser i klustret. Mer information om mått och resurshantering i Service Fabric finns i Introduktion till Service Fabric-kluster Resource Manager. 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 parameternamn:värdepar kan visas högst en gång.

  • MetricName. Anger namnet på måttet.
  • NodeReservationCapacity. Anger den mängd måttbelastning som är reserverad på 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 NodeReservationCapacity har angetts får produkten MinimumNodes och NodeReservationCapacity inte vara mer än TotalApplicationCapacity.
Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumNodes

Anger antalet noder i ett kluster där kapaciteten är reserverad för det här programmet, vilket inte innebär att programmet garanterat har 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.

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

-RemoveApplicationCapacity

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

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

-TimeoutSec

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

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

Indata

None

Utdata

System.Object