Udostępnij za pośrednictwem

Update-ServiceFabricApplication

  • Odwołanie
Moduł:
ServiceFabric

Aktualizacje lub usuwa pojemność aplikacji.

Składnia

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

Opis

Polecenie cmdlet Update-ServiceFabricApplication aktualizuje lub usuwa pojemność aplikacji dla aplikacji, która została już utworzona.

Pojemność aplikacji definiuje maksymalną/minimalną liczbę węzłów dla aplikacji, a także pojemność na węzeł dla jej metryk.

Przykłady

Przykład 1: Aktualizowanie węzłów MaximumNode i metryk

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

To polecenie aktualizuje sieć szkieletową aplikacji:/MyApp, aby używać maksymalnie sześciu węzłów. Każdy węzeł ma zarezerwowane obciążenie dwóch jednostek i maksymalne obciążenie 12 jednostek dla metryki procesora CPU w każdym węźle. Łączna pojemność aplikacji to 16 jednostek dla metryki procesora CPU. Wartość parametru MinimumNodes pozostaje niezmieniona.

Przykład 2: Aktualizowanie węzłów MaximumNodes i resetowanie metryk

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

To polecenie aktualizuje sieć szkieletową aplikacji:/MyApp do używania maksymalnie sześciu węzłów i usuwa pojemności dla wszystkich metryk. Jeśli istnieją jakiekolwiek wcześniej zdefiniowane pojemności, są one wyczyszczone po tym poleceniu. Wartość parametru MinimumNodes jest niezmieniona.

Przykład 3: Aktualizowanie wszystkich parametrów pojemności aplikacji

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

To polecenie aktualizuje sieć szkieletową aplikacji:/MyApp, aby używać maksymalnie sześciu węzłów. Każdy węzeł ma zarezerwowane obciążenie dwóch jednostek i maksymalne obciążenie 12 jednostek dla procesora CPU metryki w każdym węźle. Łączna pojemność aplikacji to 16 jednostek dla metryki procesora CPU. Wartość węzłów minimalnych jest aktualizowana do 2, aby usługa Service Fabric zarezerwowała łączną pojemność wynoszącą cztery jednostki dla metryki procesora CPU w klastrze.

Przykład 4. Usuwanie wszystkich parametrów pojemności aplikacji

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

To polecenie aktualizuje sieć szkieletową aplikacji:/MyApp, aby nie miała zdefiniowanych parametrów pojemności aplikacji. Jeśli aplikacja MyApp miała wcześniej ustawione parametry pojemności, ta operacja je czyści.

Parametry

-ApplicationName

Określa nazwę aplikacji do zaktualizowania.

Typ:Uri
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MaximumNodes

Określa maksymalną liczbę węzłów, na których ma być umieszczana aplikacja. Wartość tego parametru musi być nieujemną liczbą całkowitą. Wartość domyślna to 0, co oznacza, że aplikację można umieścić w dowolnej liczbie węzłów w klastrze.

Jeśli nie określisz tego parametru, aplikacja używa istniejącej maksymalnej liczby węzłów ustawionych dla aplikacji.

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Metrics

Określa tablicę metryk. Te metryki są używane przez klaster usługi Service Fabric Resource Manager do zarządzania zasobami w klastrze. Aby uzyskać więcej informacji na temat metryk i zarządzania zasobami w usłudze Service Fabric, zobacz Service Fabric Cluster Resource Manager Introduction (Wprowadzenie do klastra usługi Service Fabric). Każda metryka może podążać za wzorcem MetricName,NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity lub może określić nazwę MetricName i użyć nazw parametrów NodeReservationCapacity,MaximumNodeCapacity,TotalApplicationCapacity, po którym następuje wartość parametru oddzielona dwukropkiem. Każda para parametrów name:value może być wyświetlana co najwyżej raz.

  • MetricName. Określa nazwę metryki.
  • NodeReservationCapacity. Określa ilość obciążenia metryki zarezerwowanego w węzłach, które mają wystąpienia tej aplikacji. Jeśli określono wartość MinimumNodes , produktem tych wartości jest pojemność zarezerwowana w klastrze dla aplikacji.
  • MaximumNodeCapacity. Określa maksymalne obciążenie wystąpienia tej aplikacji w jednym węźle. Nawet jeśli pojemność węzła jest większa niż ta wartość, usługa Service Fabric ogranicza całkowite obciążenie replik podrzędnych aplikacji do tej wartości.
  • TotalApplicationCapacity. Określa łączną pojemność aplikacji w klastrze. Usługa Service Fabric próbuje ograniczyć sumę obciążeń replik podrzędnych aplikacji do tej wartości.

Podczas aktualizowania pojemności usługa Service Fabric przeprowadza następujące walidacje i zakończy się niepowodzeniem polecenia, jeśli nie zostaną przekazane:

  • Wartość NodeReservationCapacity nie może przekraczać wartości MaximumNodeCapacity.
  • Jeśli określono zarówno parametr MinimumNodes , jak i metryki NodeReservationCapacity, produkt MinimumNodes i NodeReservationCapacity nie może być większy niż TotalApplicationCapacity.
Typ:String[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MinimumNodes

Określa liczbę węzłów w klastrze, w którym pojemność jest zarezerwowana dla tej aplikacji. Nie oznacza to, że aplikacja ma gwarancję posiadania replik na wszystkich tych węzłach. Wartość tego parametru musi być nieujemną liczbą całkowitą. Wartość domyślna dla tej wartości to zero, co oznacza, że żadna pojemność nie jest zarezerwowana dla aplikacji.

Jeśli parametr MinimumNodes ma wartość 0, żadna pojemność nie jest zarezerwowana.

Typ:Int64
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RemoveApplicationCapacity

Wskazuje, że ta operacja czyści wszystkie parametry związane z pojemnością aplikacji dla aplikacji. Jeśli określisz ten parametr, nie można określić parametru Metrics w celu zaktualizowania pojemności aplikacji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
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

None

Dane wyjściowe

System.Object