Update-ServiceFabricPartitionLoad
Aktualizuje zatížení zadaných oddílů Service Fabric.
Syntaxe
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
Rutina Update-ServiceFabricPartitionLoad aktualizuje zatížení oddílů Service Fabric zadaných prostřednictvím PartitionMetricLoadDescriptionList
a vrátí výsledky.
Před provedením jakékoli operace v clusteru Service Fabric vytvořte připojení ke clusteru pomocí rutiny Connect-ServiceFabricCluster.
Příklady
Příklad 1: Použití Update-ServiceFabricParitionLoad k hlášení různých zatížení oddílu
# 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
Viz také načtení sestav pro oddíl.
Parametry
-ContinuationToken
Určuje token pokračování, který lze použít k načtení další stránky výsledků dotazu.
Pokud je zadaných filtrů respektuje příliš mnoho výsledků, nemusí se vejít do jedné zprávy. Stránkování se používá k tomuto nastavení rozdělením kolekce vrácených výsledků na samostatné stránky. Token pro pokračování se používá ke zjištění, kde předchozí stránka skončila, což má význam pouze pro samotný dotaz. Tato hodnota by měla být vygenerována spuštěním tohoto dotazu a lze ji předat do dalšího požadavku dotazu, aby bylo možné získat další stránky. Hodnota tokenu pokračování, která není null, se vrátí jako součást výsledku pouze v případě, že existuje další stránka. Pokud je tato hodnota zadaná bez možnosti -GetSinglePage
, dotaz vrátí všechny stránky počínaje hodnotou tokenu pokračování.
Typ: | String |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-GetSinglePage
Určuje, jestli dotaz vrátí jednu stránku výsledků dotazu s hodnotou tokenu pokračování nebo všechny stránky zkombinované do jednoho seznamu výsledků. Pokud je tato možnost vybraná, zodpovídá volající dotaz, aby zkontroloval další stránky.
Typ: | SwitchParameter |
Position: | Named |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-MaxResults
Určuje maximální počet výsledných položek, které lze vrátit na stránku. Tím se definuje horní mez počtu vrácených výsledků, nikoli minimálně. Pokud například stránka vyhovuje maximálně 1 000 vrácených položek podle maximálního omezení velikosti zprávy definované v konfiguraci a hodnota MaxResults je nastavená na 2000, vrátí se pouze 1 000 výsledků, i když 2000 výsledků odpovídá popisu dotazu. Tato hodnota vyžaduje výběr příznaku GetSinglePage
; jinak se bude ignorovat.
Typ: | Int64 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
-PartitionMetricLoadDescriptionList
Seznam PartitionMetricLoadDescription objekty, které určují aktualizace načítání pro konkrétní oddíly Service Fabric.
Typ: | System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription] |
Position: | 0 |
Default value: | None |
Vyžadováno: | True |
Přijmout vstup kanálu: | True |
Přijmout zástupné znaky: | False |
-TimeoutSec
Určuje časový limit operace v sekundách.
Typ: | Int32 |
Position: | Named |
Default value: | None |
Vyžadováno: | False |
Přijmout vstup kanálu: | False |
Přijmout zástupné znaky: | False |
Vstupy
System.Collections.Generic.List`1[[System.Fabric.Description.PartitionMetricLoadDescription, System.Fabric, Version=8.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
Výstupy
System.Object