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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Accepted values:Zero, Low, Medium, High, VeryHigh
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DropSourceReplicaOnMove

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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).

Type:InstanceLifecycleDescription
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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).

Type:ReplicaLifecycleDescription
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Type:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceDnsName

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ServiceName

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

Type:Uri
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ServicePlacementTimeLimit

Ustawia limit czasu umieszczania usługi.

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StandByReplicaKeepDuration

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

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

Type:TimeSpan
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Stateful

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

Type:SwitchParameter
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Stateless

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

Type:SwitchParameter
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TimeoutSec

Określa limit czasu dla operacji w sekundach.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wejściowe

System.Uri

Dane wyjściowe

System.Object