Delen via

Update-ServiceFabricPartitionLoad

  • Referentie
Module:
ServiceFabric

Updates de opgegeven Service Fabric-partities.

Syntaxis

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>]

Description

De cmdlet Update-ServiceFabricPartitionLoad werkt de belasting van Service Fabric-partities bij, zoals opgegeven via PartitionMetricLoadDescriptionList, en retourneert vervolgens de resultaten.

Voordat u een bewerking uitvoert op een Service Fabric-cluster, maakt u een verbinding met het cluster met behulp van de cmdlet Connect-ServiceFabricCluster .

Voorbeelden

Voorbeeld 1: gebruik Update-ServiceFabricParitionLoad om verschillende belastingen voor een partitie te rapporteren

# 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

Zie ook De belasting van een partitie rapporteren.

Parameters

-ContinuationToken

Hiermee geeft u het vervolgtoken op dat kan worden gebruikt om de volgende pagina met queryresultaten op te halen.

Als te veel resultaten de opgegeven filters respecteren, passen ze mogelijk niet in één bericht. Paging wordt gebruikt om hiervoor rekening te houden door de verzameling geretourneerde resultaten op te splitsen in afzonderlijke pagina's. Het vervolgtoken wordt gebruikt om te weten waar de vorige pagina is gebleven, wat alleen significantie aan de query zelf heeft. Deze waarde moet worden gegenereerd door deze query uit te voeren en kan worden doorgegeven aan de volgende queryaanvraag om volgende pagina's op te halen. Een niet-null-vervolgtokenwaarde wordt alleen geretourneerd als onderdeel van het resultaat als er een volgende pagina is. Als deze waarde wordt opgegeven zonder de -GetSinglePage optie, retourneert de query alle pagina's die beginnen met de vervolgtokenwaarde.

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

-GetSinglePage

Hiermee geeft u op of de query één pagina met queryresultaten retourneert met een vervolgtokenwaarde, of alle pagina's gecombineerd tot één lijst met resultaten. Als deze optie is geselecteerd, is het de verantwoordelijkheid van de aanroeper van de query om te controleren op volgende pagina's.

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

-MaxResults

Hiermee geeft u het maximum aantal resultaatitems op dat per pagina kan worden geretourneerd. Hiermee definieert u de bovengrens voor het aantal geretourneerde resultaten, niet een minimum. Als de pagina bijvoorbeeld maximaal 1000 geretourneerde items past volgens de beperkingen voor maximale berichtgrootte die zijn gedefinieerd in de configuratie en de waarde MaxResults is ingesteld op 2000, worden er slechts 1000 resultaten geretourneerd, zelfs als 2000 resultaatitems overeenkomen met de querybeschrijving. Voor deze waarde is selectie van de GetSinglePage vlag vereist. Anders wordt deze genegeerd.

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

-PartitionMetricLoadDescriptionList

Lijst met PartitionMetricLoadDescription-objecten die laadupdates voor specifieke Service Fabric-partities opgeven.

Type:System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
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

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

Uitvoerwaarden

System.Object