Freigeben über

Update-ServiceFabricPartitionLoad

  • Referenz
Modul:
ServiceFabric

Aktualisiert Lasten der angegebenen Service Fabric-Partitionen.

Syntax

Update-ServiceFabricPartitionLoad
      [-PartitionMetricLoadDescriptionList] <System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription]>
      [-ContinuationToken <String>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]
Update-ServiceFabricPartitionLoad
      [-PartitionMetricLoadDescriptionList] <System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription]>
      [-GetSinglePage]
      [-ContinuationToken <String>]
      [-MaxResults <Int64>]
      [-TimeoutSec <Int32>]
      [<CommonParameters>]

Beschreibung

Das cmdlet Update-ServiceFabricPartitionLoad cmdlet aktualisiert die Lasten der Service Fabric-Partitionen, wie über PartitionMetricLoadDescriptionListangegeben, und gibt dann die Ergebnisse zurück.

Bevor Sie einen Vorgang auf einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Verwenden von Update-ServiceFabricParitionLoad zum Melden verschiedener Ladevorgänge für eine Partition

# This demonstrates various ways in which Update-ServiceFabricPartitionLoad can be used to report loads for a partition
# Part 1: reporting primary load for one or more metrics
# Part 2: reporting secondary load for one or more metrics
# Part 3: reporting loads for a given replica on a given node

# We need a guid object to identify the partition
$partitionIdString = '12345678-9012-4242-9876-432109876543'
$partitionId = [GUID]$partitionIdString

# Part 1: report primary load 42 for Metric0 and 43 for Metric1
$primaryLoad0 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric0', 42)
$primaryLoad1 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric1', 43)
$primaryLoads = New-Object 'System.Collections.Generic.List[System.Fabric.Description.MetricLoadDescription]'
$primaryLoads.Add($primaryLoad0)
$primaryLoads.Add($primaryLoad1)

# Part 2: report secondary load 5 for Metric0 and 6 for Metric1
$secondaryLoads = New-Object 'System.Collections.Generic.List[System.Fabric.Description.MetricLoadDescription]'
$secondaryLoad0 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric0', 5)
$secondaryLoad1 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric1', 6)
$secondaryLoads.Add($secondaryLoad0)
$secondaryLoads.Add($secondaryLoad1)

# Part 3a: for the replica on Node0 report a load of 42 for Metric0 and 24 for Metric1
$perNodeSecondaryLoads0 = New-Object 'System.Collections.Generic.List[System.Fabric.Description.MetricLoadDescription]'
$perNodeSecondaryLoad00 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric0', 42)
$perNodeSecondaryLoad01 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric1', 24)
$perNodeSecondaryLoads0.Add($perNodeSecondaryLoad00)
$perNodeSecondaryLoads0.Add($perNodeSecondaryLoad01)
$perNodeLoadsNode0 = New-Object -TypeName System.Fabric.Description.ReplicaMetricLoadDescription("Node0", $perNodeSecondaryLoads0)

# Part 3b: for the replica on Node1 report a load of 5 for Metric0 and 6 for Metric1
$perNodeSecondaryLoads1 = New-Object 'System.Collections.Generic.List[System.Fabric.Description.MetricLoadDescription]'
$perNodeSecondaryLoad10 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric0', 5)
$perNodeSecondaryLoad11 = New-Object -TypeName System.Fabric.Description.MetricLoadDescription('Metric1', 6)
$perNodeSecondaryLoads1.Add($perNodeSecondaryLoad10)
$perNodeSecondaryLoads1.Add($perNodeSecondaryLoad11)
$perNodeLoadsNode1 = New-Object -TypeName System.Fabric.Description.ReplicaMetricLoadDescription("Node1", $perNodeSecondaryLoads1)

# Part 3c: put all node loads in an aggregate list
$perNodeLoads = New-Object 'System.Collections.Generic.List[System.Fabric.Description.ReplicaMetricLoadDescription]'
$perNodeLoads.Add($perNodeLoadsNode0)
$perNodeLoads.Add($perNodeLoadsNode1)

# Generate a description object which can contain all 3 load types (primary, secondary and per node)
# Empty dummy lists can be passed to the constructor if not all 3 types of reporting are used
$loadDescription = New-Object -TypeName System.Fabric.Description.PartitionMetricLoadDescription($partitionId, $primaryLoads, $secondaryLoads, $perNodeLoads)

# Create the final list of descriptions
# In this example we are reporting the load for a single partition
# But in general, more descriptions can be added to partitionMetricLoadDescriptionList
# This way, loads for multiple partitions can be reported through a single Update-ServiceFabricPartitionLoad call
$partitionMetricLoadDescriptionList = New-Object 'System.Collections.Generic.List[System.Fabric.Description.PartitionMetricLoadDescription]'
$partitionMetricLoadDescriptionList.Add($loadDescription)

# Finally, report the loads
Update-ServiceFabricPartitionLoad -PartitionMetricLoadDescriptionList $partitionMetricLoadDescriptionList

Siehe auch Berichtsladevorgang für eine Partition.

Parameter

-ContinuationToken

Gibt das Fortsetzungstoken an, mit dem die nächste Seite der Abfrageergebnisse abgerufen werden kann.

Wenn zu viele Ergebnisse die bereitgestellten Filter berücksichtigen, passen sie möglicherweise nicht in eine Nachricht. Paging wird verwendet, um dies zu berücksichtigen, indem die Sammlung der zurückgegebenen Ergebnisse in separate Seiten aufgeteilt wird. Das Fortsetzungstoken wird verwendet, um zu wissen, wo die vorherige Seite aufgehört hat, wobei nur die Abfrage selbst von Bedeutung ist. Dieser Wert sollte aus der Ausführung dieser Abfrage generiert werden und kann an die nächste Abfrageanforderung übergeben werden, um nachfolgende Seiten abzurufen. Ein Nicht-NULL-Fortsetzungstokenwert wird nur als Teil des Ergebnisses zurückgegeben, wenn eine nachfolgende Seite vorhanden ist. Wenn dieser Wert ohne die Option -GetSinglePage bereitgestellt wird, gibt die Abfrage alle Seiten ab dem Fortsetzungstokenwert zurück.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GetSinglePage

Gibt an, ob die Abfrage eine Seite mit Abfrageergebnissen mit einem Fortsetzungstokenwert zurückgibt, oder ob alle Seiten in einer Liste von Ergebnissen kombiniert werden. Wenn diese Option ausgewählt ist, liegt es in der Verantwortung des Aufrufers der Abfrage, nach nachfolgenden Seiten zu suchen.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaxResults

Gibt die maximale Anzahl von Ergebniselementen an, die pro Seite zurückgegeben werden können. Dadurch wird die obere Grenze für die Anzahl der zurückgegebenen Ergebnisse definiert, nicht mindestens. Wenn die Seite beispielsweise maximal 1000 zurückgegebene Elemente gemäß den in der Konfiguration definierten Einschränkungen für die maximale Nachrichtengröße einpasst und der MaxResults-Wert auf 2000 festgelegt ist, werden nur 1000 Ergebnisse zurückgegeben, auch wenn 2000 Ergebniselemente der Abfragebeschreibung entsprechen. Für diesen Wert ist die Auswahl des GetSinglePage-Flags erforderlich; andernfalls wird sie ignoriert.

Typ:Int64
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartitionMetricLoadDescriptionList

Liste der PartitionMetricLoadDescription Objekte, die Ladeupdates für bestimmte Service Fabric-Partitionen angeben.

Typ:System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum für den Vorgang in Sekunden an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.Collections.Generic.List`1[[System.Fabric.Description.PartitionMetricLoadDescription, System.Fabric, Version=8.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Ausgaben

System.Object