Udostępnij za pośrednictwem

Update-ServiceFabricService

  • Odwołanie
Moduł:
ServiceFabric

Aktualizacje usługę Service Fabric.

Składnia

Update-ServiceFabricService
      [-Stateless]
      [-ServiceName] <Uri>
      [-InstanceCount <Int32>]
      [-MinInstanceCount <Int32>]
      [-MinInstancePercentage <Int32>]
      [-InstanceLifecycleDescription <InstanceLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-InstanceCloseDelayDuration <TimeSpan>]
      [-InstanceRestartWaitDuration <TimeSpan>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-ServiceFabricService
      [-Stateful]
      [-ServiceName] <Uri>
      [-TargetReplicaSetSize <Int32>]
      [-MinReplicaSetSize <Int32>]
      [-ReplicaRestartWaitDuration <TimeSpan>]
      [-QuorumLossWaitDuration <TimeSpan>]
      [-StandByReplicaKeepDuration <TimeSpan>]
      [-ServicePlacementTimeLimit <TimeSpan>]
      [-DropSourceReplicaOnMove <Boolean>]
      [-ReplicaLifecycleDescription <ReplicaLifecycleDescription>]
      [-Force]
      [-PlacementConstraints <String>]
      [-Metric <String[]>]
      [-Correlation <String[]>]
      [-PlacementPolicy <String[]>]
      [-DefaultMoveCost <String>]
      [-PartitionNamesToAdd <String[]>]
      [-PartitionNamesToRemove <String[]>]
      [-ScalingPolicies <System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]>]
      [-ServiceDnsName <String>]
      [-TagsRequiredToPlace <System.Collections.Generic.List`1[System.String]>]
      [-TagsRequiredToRun <System.Collections.Generic.List`1[System.String]>]
      [-TimeoutSec <Int32>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Opis

Polecenie cmdlet Update-ServiceFabricService aktualizuje właściwości uruchomionej usługi Service Fabric. Zestaw właściwości, które można zaktualizować, to podzbiór właściwości, które zostały określone podczas tworzenia usługi (przy użyciu lub New-ServiceFabricServiceNew-ServiceFabricServiceFromTemplate). Bieżące właściwości usługi można uzyskać przy użyciu polecenia Get-ServiceFabricServiceDescription.

Należy pamiętać, że aktualizowanie właściwości uruchomionej usługi różni się od uaktualniania usługi przy użyciu polecenia Start-ServiceFabricApplicationUpgrade. Uaktualnianie usługi (tj. aplikacji) to długotrwałe zadanie w tle, które obejmuje przeniesienie aplikacji z jednej wersji do innej, jednej domeny uaktualnienia naraz. Aby uzyskać więcej informacji, zobacz Uaktualnianie aplikacji usługi Service Fabric .

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. Aktualizowanie usługi stanowej

PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5

To polecenie aktualizuje wartości MinReplicaSetSize i TargetReplicaSetSize działającej usługi Fabric do trzech (3) i pięciu (5).

Przykład 2. Aktualizowanie usługi bezstanowej

PS C:\> Update-ServiceFabricService -Stateless fabric:/myapp/test -InstanceCount -1

To polecenie aktualizuje liczbę wystąpień uruchomionej usługi fabric do wartości -1.

Przykład 3. Aktualizowanie ograniczeń umieszczania

PS C:\> Update-ServiceabricService -Stateless -ServiceName fabric:/myapp/test -PlacementConstraints "NodeName!=NodeBar"

To polecenie aktualizuje ograniczenia umieszczania.

Przykład 4. Aktualizowanie domyślnych metryk obciążenia

PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -Metric @("CPU,High,10")
PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Metric @("CPU,High,10,1")

Pierwsze polecenie aktualizuje domyślne metryki obciążenia dla usługi bezstanowej.

Drugie polecenie aktualizuje domyślne metryki obciążenia dla usługi stanowej.

Przykład 5. Aktualizowanie zasad umieszczania

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -PlacementPolicy @("InvalidDomain,fd:/dc2/rack2")

To polecenie aktualizuje zasady umieszczania.

Przykład 6. Korelacja usługi aktualizacji

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -Correlation @("fabric:/app/test2,AlignedAffinity")

To polecenie aktualizuje korelację usługi.

Przykład 7. Aktualizowanie nazwy DNS usługi

PS C:\> Update-ServiceFabricService -Stateful -ServiceName fabric:/myapp/test -ServiceDnsName stateful.dns
PS C:\> Update-ServiceFabricService -Stateless -ServiceName fabric:/myapp/test -ServiceDnsName stateless.dns

To polecenie aktualizuje nazwę DNS usługi. Uwaga: jeśli zaktualizowana nazwa DNS została już odpytywane w klastrze lub usługa aktualizacji ma już nazwę DNS, należy ponownie uruchomić usługę DNS po aktualizacji, aby unieważnić pamięć podręczną.

Parametry

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Correlation

Określa zaktualizowaną tablicę ograniczeń korelacji dla tej usługi. Aby dowiedzieć się więcej na temat korelacji usług, zobacz Konfigurowanie i używanie koligacji usługi w usłudze Service Fabric.

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

-DefaultMoveCost

Określa zaktualizowany domyślny koszt przenoszenia, który mają repliki podczas ich tworzenia. Dopuszczalne wartości dla tego parametru to:

  • Zero
  • Niski
  • Śred.
  • Wys.

Aby uzyskać więcej informacji na temat kosztów przenoszenia, zobacz Koszty przenoszenia usługi w celu wpływania na opcje Resource Manager klastra.

Typ:String
Dopuszczalne wartości:Zero, Low, Medium, High, VeryHigh
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DropSourceReplicaOnMove

Umożliwia porzucanie źródłowych replik pomocniczych przed zakończeniem kompilacji nowych replik pomocniczych.

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

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

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

-InstanceCloseDelayDuration

Określa czas trwania w sekundach, aby poczekać przed zamknięciem wystąpienia bezstanowego, na które ma wpływ uaktualnienie aplikacji, aby umożliwić aktywne żądania w sposób bezproblemowy opróżniania. Ten czas oczekiwania jest skuteczny tylko dla wystąpień tych usług bezstanowych, które mają niezerową wartość skonfigurowaną dla klasy InstanceCloseDelayDuration i zastąpią wstępnie skonfigurowaną wartość. Aby uzyskać szczegółowe informacje, zobacz InstanceCloseDelayDuration . Nie należy określać tego parametru dla usług stanowych.

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

-InstanceCount

Określa zaktualizowaną liczbę wystąpień usługi bezstanowej usługi Service Fabric. Nie należy określać tego parametru dla usług stanowych.

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

-InstanceLifecycleDescription

Opis cyklu życia wystąpień należących do tej usługi. Jeśli nie określono konfiguracji w tej sekcji, wartość domyślna zostanie pobrana z parametru klastra o tej samej nazwie (jeśli istnieje).

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

-InstanceRestartWaitDuration

Gdy wystąpienie bezstanowe ulegnie awarii, ten czasomierz zostanie uruchomiony. Po wygaśnięciu usługi Service Fabric zostanie utworzone nowe wystąpienie w dowolnym węźle w klastrze. Ta konfiguracja polega na zmniejszeniu niepotrzebnego tworzenia nowego wystąpienia w sytuacjach, w których wystąpienie ulegnie awarii, prawdopodobnie zostanie odzyskane w krótkim czasie. Na przykład podczas uaktualniania. Wartość domyślna to 0, co oznacza, że gdy wystąpienie bezstanowe ulegnie awarii, usługa Service Fabric natychmiast zacznie kompilować jego zastąpienie.

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

-Metric

Określa zaktualizowaną tablicę metryk zgłaszanych przez usługę. Aby dowiedzieć się więcej na temat metryk, zobacz Zarządzanie zużyciem zasobów i ładowaniem w usłudze Service Fabric przy użyciu metryk.

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

-MinInstanceCount

Określa zaktualizowaną minimalną liczbę wystąpień partycji usługi bezstanowej. Aby uzyskać szczegółowe informacje, zobacz MinInstanceCount (w New-ServiceFabricServicesystemie ). Nie należy określać tego parametru dla usług stanowych.

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

-MinInstancePercentage

Określa zaktualizowany minimalny procent liczby wystąpień partycji usługi bezstanowej. Aby uzyskać szczegółowe informacje, zobacz MinInstancePercentage (w New-ServiceFabricServicesystemie ). Nie należy określać tego parametru dla usług stanowych.

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

-MinReplicaSetSize

Określa zaktualizowany minimalny rozmiar zestawu replik dla usługi stanowej usługi Service Fabric. Wartość musi być mniejsza niż TargetReplicaSetSize tej usługi. Aby uzyskać więcej informacji, zobacz StatefulServiceDescription.MinReplicaSetSize.

Nie należy określać tego parametru dla usług bezstanowych.

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

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

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

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

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

-PlacementConstraints

Określa zaktualizowane ograniczenie umieszczania dla usługi. Aby dowiedzieć się więcej na temat ograniczeń umieszczania, zobacz Ograniczenia umieszczania i właściwości węzła.

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

-PlacementPolicy

Określa zaktualizowaną tablicę zasad umieszczania dla usługi. Aby dowiedzieć się więcej na temat zasad umieszczania, zobacz Zasady umieszczania dla usług service fabric.

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

-QuorumLossWaitDuration

Określa zaktualizowany czas trwania jako obiekt TimeSpan , który usługa Service Fabric czeka przed zadeklarowanie utraty danych dla partycji usługi.

Aby uzyskać obiekt TimeSpan , użyj polecenia cmdlet New-TimeSpan . Aby uzyskać więcej informacji, wpisz polecenie Get-Help New-TimeSpan.

Aby dowiedzieć się więcej o parametrze QuorumLossWaitDuration, zobacz StatefulServiceDescription.QuorumLossWaitDuration.

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

-ReplicaLifecycleDescription

Opis cyklu życia replik należących do tej usługi. Jeśli nie określono konfiguracji w tej sekcji, wartość domyślna zostanie pobrana z parametru klastra o tej samej nazwie (jeśli istnieje).

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

-ReplicaRestartWaitDuration

Określa zaktualizowany interwał, jako obiekt TimeSpan , że usługa Service Fabric czeka na ponowne uruchomienie repliki przed utworzeniem repliki zastępczej. Aby uzyskać obiekt TimeSpan , użyj polecenia cmdlet New-TimeSpan .

Aby dowiedzieć się więcej o kworumLossWaitDuration, zobacz StatefulServiceDescription.ReplicaRestartWaitDuration.

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

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Typ:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-ServiceDnsName

Określa zaktualizowaną nazwę DNS usługi.

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

-ServiceName

Określa identyfikator URI usługi Service Fabric, którego właściwości należy zaktualizować.

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

-ServicePlacementTimeLimit

Ustawia limit czasu umieszczania usługi.

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

-StandByReplicaKeepDuration

Określa czas trwania aktualizacji repliki rezerwowej jako obiekt TimeSpan .

Aby dowiedzieć się więcej o kworumLossWaitDuration, zobacz StatefulServiceDescription.StandByReplicaKeepDuration.

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

-Stateful

Wskazuje, że usługa jest usługą stanową usługi Service Fabric.

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

-Stateless

Wskazuje, że usługa jest usługą bezstanową usługi Service Fabric.

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

-TagsRequiredToPlace

Deklaruje tagi wymagane do umieszczania usługi. Przydatne do dynamicznego wpływania na umieszczanie usług. Aby uzyskać więcej informacji, zobacz Tagi dynamiczne węzła usługi Service Fabric.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TagsRequiredToRun

Deklaruje tagi wymagane do umieszczania i uruchamiania usługi. Przydatne w przypadku dynamicznego wpływania na umieszczanie i uruchamianie usługi. Aby uzyskać więcej informacji, zobacz Tagi dynamicznego węzła usługi Service Fabric

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-TargetReplicaSetSize

Określa zaktualizowany rozmiar zestawu replik docelowych dla usługi stanowej usługi Service Fabric. Aby uzyskać więcej informacji, zobacz StatefulServiceDescription.TargetReplicaSetSize.

Nie należy określać tego parametru dla usługi bezstanowej.

Typ:Int32
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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Domyślna wartość:False
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

System.Uri

Dane wyjściowe

System.Object