Delen via

Update-ServiceFabricApplication

  • Referentie
Module:
ServiceFabric

Updates of verwijdert de toepassingscapaciteit.

Syntaxis

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

Description

De cmdlet Update-ServiceFabricApplication wordt bijgewerkt of verwijdert de toepassingscapaciteit voor een toepassing die al is gemaakt.

Toepassingscapaciteit definieert het maximum/minimumknooppunt voor een toepassing, evenals de capaciteit per knooppunt voor de metrische gegevens.

Voorbeelden

Voorbeeld 1: MaximumNodes en metrische gegevens bijwerken

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

Met deze opdracht wordt de toepassingsinfrastructuur bijgewerkt:/MyApp kan maximaal zes knooppunten worden gebruikt. Elk knooppunt heeft een gereserveerde belasting van twee eenheden en een maximale belasting van 12 eenheden voor de CPU-metrische gegevens op elk knooppunt. De totale capaciteit van de toepassing is 16 eenheden voor de METrische CPU-waarde. De waarde voor MinimumNodes blijft ongewijzigd.

Voorbeeld 2: MaximumNodes bijwerken en metrische gegevens opnieuw instellen

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

Met deze opdracht wordt de toepassingsinfrastructuur bijgewerkt:/MyApp kan maximaal zes knooppunten worden gebruikt en worden capaciteiten voor alle metrische gegevens verwijderd. Als er eerder gedefinieerde capaciteiten zijn, worden ze na deze opdracht gewist. De waarde voor MinimumNodes is ongewijzigd.

Voorbeeld 3: Alle parameters voor toepassingscapaciteit bijwerken

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

Met deze opdracht wordt de toepassingsinfrastructuur bijgewerkt:/MyApp kan maximaal zes knooppunten worden gebruikt. Elk knooppunt heeft een gereserveerde belasting van twee eenheden en een maximale belasting van 12 eenheden voor de metrische CPU op elk knooppunt. De totale capaciteit van de toepassing is 16 eenheden voor de METrische CPU-waarde. De waarde voor minimale knooppunten wordt bijgewerkt naar 2, zodat Service Fabric een totale capaciteit van vier eenheden voor de METrische CPU-waarde in het cluster behoudt.

Voorbeeld 4: Alle toepassingscapaciteitsparameters verwijderen

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

Met deze opdracht wordt de toepassingsinfrastructuur bijgewerkt:/MyApp, zodat er geen parameters voor toepassingscapaciteit zijn gedefinieerd. Als MyApp eerder capaciteitsparameters had ingesteld, wist deze bewerking deze.

Parameters

-ApplicationName

Hiermee geeft u de naam van de toepassing die moet worden bijgewerkt.

Type:Uri
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaximumNodes

Hiermee geeft u het maximum aantal knooppunten op waarop u een toepassing wilt plaatsen. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde is 0, wat aangeeft dat de toepassing op een willekeurig aantal knooppunten in het cluster kan worden geplaatst.

Als u deze parameter niet opgeeft, gebruikt de toepassing het bestaande maximum aantal knooppunten dat is ingesteld voor de toepassing.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Metrics

Hiermee geeft u een matrix met metrische gegevens op. Deze metrische gegevens worden gebruikt door Service Fabric-cluster Resource Manager om resources in het cluster te beheren. Zie Service Fabric-cluster Resource Manager Inleiding voor meer informatie over metrische gegevens en resourcebeheer in Service Fabric. Elke metrische waarde kan het patroon MetricName, NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity volgen of metricName opgeven en parameternamen NodeReservationCapacity, MaximumNodeCapacity, TotalApplicationCapacity gevolgd door een parameterwaarde gescheiden door een dubbele punt. Elke parameternaam:waardepaar kan maximaal één keer worden weergegeven.

  • MetricName. Hiermee geeft u de naam van de metrische waarde op.
  • NodeReservationCapacity. Hiermee geeft u de hoeveelheid metrische belasting op die is gereserveerd op knooppunten met exemplaren van deze toepassing. Als MinimumNodes is opgegeven, is het product van deze waarden de capaciteit die is gereserveerd in het cluster voor de toepassing.
  • MaximumNodeCapacity. Hiermee geeft u de maximale belasting voor een exemplaar van deze toepassing op één knooppunt. Zelfs als de capaciteit van het knooppunt groter is dan deze waarde, beperkt Service Fabric de totale belasting van de onderliggende replica's van de toepassing tot deze waarde.
  • TotalApplicationCapacity. Hiermee geeft u de totale capaciteit voor de toepassing in het cluster op. Service Fabric probeert de som van de belastingen van de onderliggende replica's van de toepassing tot deze waarde te beperken.

Tijdens het bijwerken van de capaciteit voert Service Fabric de volgende validaties uit en mislukt de opdracht als deze niet worden doorgegeven:

  • NodeReservationCapacity mag niet meer zijn dan MaximumNodeCapacity.
  • Als zowel de parameter MinimumNodes als de metric NodeReservationCapacity zijn opgegeven, mag het product van MinimumNodes en NodeReservationCapacity niet meer zijn dan TotalApplicationCapacity.
Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinimumNodes

Hiermee geeft u het aantal knooppunten in een cluster waarop capaciteit is gereserveerd voor deze toepassing. Dit betekent niet dat de toepassing gegarandeerd replica's op al deze knooppunten heeft. De waarde van deze parameter moet een niet-negatief geheel getal zijn. De standaardwaarde hiervoor is nul, wat betekent dat er geen capaciteit is gereserveerd voor de toepassing.

Als MinimumNodes is ingesteld op 0, is er geen capaciteit gereserveerd.

Type:Int64
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RemoveApplicationCapacity

Geeft aan dat met deze bewerking alle parameters met betrekking tot toepassingscapaciteit voor de toepassing worden gewist. Als u deze parameter opgeeft, kunt u de parameter Metrics niet opgeven om de capaciteit van de toepassing bij te werken.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-TimeoutSec

Hiermee geeft u de time-outperiode, in seconden, voor de bewerking op.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Uitvoerwaarden

System.Object