Update-ServiceFabricApplication
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