Update-ServiceFabricPartitionLoad
Aktualizacje obciążenia określonych partycji usługi Service Fabric.
Składnia
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>]
Opis
Polecenie cmdlet Update-ServiceFabricPartitionLoad aktualizuje obciążenia partycji usługi Service Fabric zgodnie z opisem za pomocą PartitionMetricLoadDescriptionList
polecenia , a następnie zwraca wyniki.
Przed wykonaniem dowolnej operacji w klastrze usługi Service Fabric nawiąż połączenie z klastrem przy użyciu polecenia cmdlet Connect-ServiceFabricCluster .
Przykłady
Przykład 1. Używanie Update-ServiceFabricParitionLoad do raportowania różnych obciążeń dla partycji
# 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
Zobacz też Raportowanie obciążenia partycji.
Parametry
-ContinuationToken
Określa token kontynuacji, który może służyć do pobierania następnej strony wyników zapytania.
Jeśli zbyt wiele wyników uwzględnia podane filtry, mogą nie mieścić się w jednym komunikacie. Stronicowanie jest używane do tego celu przez podzielenie kolekcji zwróconych wyników na oddzielne strony. Token kontynuacji służy do poznania, gdzie została przerwana poprzednia strona, przenosząc znaczenie tylko do samego zapytania. Ta wartość powinna być generowana z uruchamiania tego zapytania i może zostać przekazana do następnego żądania zapytania w celu pobrania kolejnych stron. Wartość tokenu kontynuacji o wartości innej niż null jest zwracana w ramach wyniku tylko wtedy, gdy istnieje kolejna strona. Jeśli ta wartość zostanie podana -GetSinglePage
bez opcji, zapytanie zwróci wszystkie strony rozpoczynające się od wartości tokenu kontynuacji.
Typ: | String |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-GetSinglePage
Określa, czy zapytanie zwróci jedną stronę wyników zapytania z wartością tokenu kontynuacji, czy wszystkie strony połączone w jedną listę wyników. Jeśli ta opcja jest zaznaczona, obowiązkiem osoby wywołującej zapytanie jest sprawdzenie kolejnych stron.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-MaxResults
Określa maksymalną liczbę elementów wyników, które można zwrócić na stronę. Definiuje górną granicę liczby zwracanych wyników, a nie minimum. Jeśli na przykład strona pasuje do maksymalnie 1000 zwracanych elementów zgodnie z maksymalnymi ograniczeniami rozmiaru komunikatów zdefiniowanymi w konfiguracji, a wartość MaxResults jest ustawiona na 2000, zwracane są tylko 1000 wyników, nawet jeśli 2000 elementów wyników jest zgodne z opisem zapytania. Ta wartość wymaga wybrania GetSinglePage
flagi. W przeciwnym razie zostanie ona zignorowana.
Typ: | Int64 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
-PartitionMetricLoadDescriptionList
Lista obiektów PartitionMetricLoadDescription określających aktualizacje obciążenia dla określonych partycji usługi Service Fabric.
Typ: | System.Collections.Generic.List`1[System.Fabric.Description.PartitionMetricLoadDescription] |
Position: | 0 |
Domyślna wartość: | None |
Wymagane: | True |
Akceptowanie danych wejściowych potoku: | True |
Akceptowanie symboli wieloznacznych: | False |
-TimeoutSec
Określa limit czasu dla operacji w sekundach.
Typ: | Int32 |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
Akceptowanie symboli wieloznacznych: | False |
Dane wejściowe
System.Collections.Generic.List`1[[System.Fabric.Description.PartitionMetricLoadDescription, System.Fabric, Version=8.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]
Dane wyjściowe
System.Object