Freigeben über


Update-ServiceFabricService

Aktualisierungen einen Service Fabric-Dienst.

Syntax

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>]

Beschreibung

Das Cmdlet Update-ServiceFabricService aktualisiert die Eigenschaften eines ausgeführten Service Fabric-Diensts. Der Satz von Eigenschaften, die aktualisiert werden können, sind eine Teilmenge der Eigenschaften, die zum Zeitpunkt der Erstellung des Diensts (using New-ServiceFabricService oder New-ServiceFabricServiceFromTemplate) angegeben wurden. Sie können aktuelle Eigenschaften Ihres Diensts mithilfe von Get-ServiceFabricServiceDescription abrufen.

Beachten Sie, dass das Aktualisieren der Eigenschaften eines ausgeführten Diensts anders ist als das Upgrade Ihres Diensts mithilfe von Start-ServiceFabricApplicationUpgrade. Das Upgrade Ihres Diensts (d. h. Anwendung) ist eine lange ausgeführte Hintergrundaufgabe, die das Verschieben Ihrer Anwendung von einer Version in eine andere umfasst, jeweils eine Upgradedomäne. Weitere Details finden Sie unter Service Fabric Application Upgrade .

Bevor Sie einen Vorgang in einem Service Fabric-Cluster ausführen, stellen Sie mithilfe des Cmdlets Connect-ServiceFabricCluster eine Verbindung mit dem Cluster her.

Beispiele

Beispiel 1: Aktualisieren eines zustandsvollen Diensts

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

Dieser Befehl aktualisiert die MinReplicaSetSize und TargetReplicaSetSize eines ausgeführten Fabric-Diensts auf drei (3) und fünf (5).

Beispiel 2: Aktualisieren eines zustandslosen Diensts

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

Dieser Befehl aktualisiert die Instanzanzahl eines ausgeführten Fabric-Diensts auf einen Wert von -1.

Beispiel 3: Aktualisieren von Platzierungseinschränkungen

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

Dieser Befehl aktualisiert die Platzierungseinschränkungen.

Beispiel 4: Aktualisieren von Standardlademetriken

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")

Der erste Befehl aktualisiert die Standardlastmetriken für einen zustandslosen Dienst.

Der zweite Befehl aktualisiert die Standardlastmetriken für einen zustandsvollen Dienst.

Beispiel 5: Aktualisieren der Platzierungsrichtlinie

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

Dieser Befehl aktualisiert die Platzierungsrichtlinie.

Beispiel 6: Updatedienstkorrelation

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

Dieser Befehl aktualisiert die Dienstkorrelation.

Beispiel 7: Dns-Name des Updatediensts

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

Dieser Befehl aktualisiert den Dienst-DNS-Namen eines Diensts. Hinweis: Wenn der aktualisierte DNS-Name bereits im Cluster abgefragt wurde oder der Aktualisierungsdienst bereits einen DNS-Namen hatte, sollte der DNS-Dienst nach dem Update neu gestartet werden, um den Cache zu ungültig machen.

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Correlation

Gibt ein aktualisiertes Array mit Korrelationseinschränkungen für diesen Dienst an. Weitere Informationen zur Dienstkorrelation finden Sie unter Konfigurieren und Verwenden der Dienstaffinität in Service Fabric.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultMoveCost

Gibt die aktualisierten Standardverschiebungskosten an, die Replikate haben, wenn sie erstellt werden. Zulässige Werte für diesen Parameter:

  • Zero
  • Niedrig
  • Medium
  • High

Weitere Informationen zu Verschiebungskosten finden Sie unter Service-Bewegungskosten für die Einflussnahme von Cluster-Resource Manager Auswahlmöglichkeiten.

Typ:String
Zulässige Werte:Zero, Low, Medium, High, VeryHigh
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DropSourceReplicaOnMove

Ermöglicht das Ablegen von sekundären Quellreplikaten, bevor neue sekundäre Replikate den Build abgeschlossen haben.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstanceCloseDelayDuration

Gibt die Dauer in Sekunden an, um zu warten, bevor eine zustandslose Instanz, die durch das Anwendungsupgrade beeinflusst wird, geschlossen wird, damit die aktiven Anforderungen ordnungsgemäß abgelassen werden können. Diese Wartezeitdauer ist nur für instanzen dieser zustandslosen Dienste wirksam, die einen nicht null für die InstanzCloseDelayDuration konfigurierten Wert aufweisen und den vorkonfigurierten Wert überschreiben. Ausführliche Informationen finden Sie unter InstanceCloseDelayDuration . Geben Sie diesen Parameter nicht für zustandsbehaftete Dienste an.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstanceCount

Gibt die aktualisierte Anzahl von Instanzen für den Service Fabric-Zustandslosen Dienst an. Geben Sie diesen Parameter nicht für zustandsbehaftete Dienste an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstanceLifecycleDescription

Lifecycle-Beschreibung von Instanzen, die zu diesem Dienst gehören. Wenn einige Konfigurationen in diesem Abschnitt nicht angegeben sind, wird der Standardwert vom Clusterparameter desselben Namens (sofern vorhanden) entnommen.

Typ:InstanceLifecycleDescription
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstanceRestartWaitDuration

Wenn eine zustandslose Instanz abläuft, wird dieser Timer gestartet. Wenn service Fabric abläuft, wird eine neue Instanz auf einem beliebigen Knoten im Cluster erstellt. Diese Konfiguration besteht darin, die unnötige Erstellung einer neuen Instanz in Situationen zu verringern, in denen die Instanz wahrscheinlich in kurzer Zeit wiederhergestellt wird. Beispiel: während eines Upgrades. Der Standardwert ist 0, der angibt, dass Service Fabric sofort mit der Erstellung des Ersatzes beginnt, wenn zustandslose Instanz abläuft.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Metric

Gibt das aktualisierte Array von Metriken an, die von den Dienstberichten gemeldet werden. Weitere Informationen zu Metriken finden Sie unter Verwalten des Ressourcenverbrauchs und der Auslastung in Service Fabric mit Metriken.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinInstanceCount

Gibt die aktualisierte Mindestanzahl von Instanzen der zustandslosen Dienstpartition an. Ausführliche Informationen finden Sie unter MinInstanceCount (in New-ServiceFabricService) Geben Sie diesen Parameter nicht für zustandsbehaftete Dienste an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinInstancePercentage

Gibt den aktualisierten minimalen Prozentsatz von InstanceCount einer zustandslosen Dienstpartition an. Ausführliche Informationen finden Sie unter MinInstancePercentage (in New-ServiceFabricService) Geben Sie diesen Parameter nicht für zustandsbehaftete Dienste an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinReplicaSetSize

Gibt die aktualisierte mindeste Replikatsatzgröße für den Service Fabric-Zustandsdienst an. Der Wert muss kleiner als das TargetReplicaSetSize dieses Diensts sein. Weitere Informationen finden Sie unter StatefulServiceDescription.MinReplicaSetSize.

Geben Sie diesen Parameter nicht für zustandslose Dienste an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PlacementConstraints

Gibt die aktualisierte Platzierungseinschränkung für den Dienst an. Weitere Informationen zu Platzierungseinschränkungen finden Sie unter Platzierungseinschränkungen und Knoteneigenschaften.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PlacementPolicy

Gibt ein aktualisiertes Array von Platzierungsrichtlinien für einen Dienst an. Weitere Informationen zu PlacementPolicy finden Sie unter Platzierungsrichtlinien für Service Fabric-Dienste.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-QuorumLossWaitDuration

Gibt die aktualisierte Dauer als TimeSpan-Objekt an, auf die Service Fabric wartet, bevor der Datenverlust für eine Dienstpartition deklariert wird.

Verwenden Sie das Cmdlet New-TimeSpan, um ein TimeSpan-Objekt abzurufen. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help New-TimeSpan.

Weitere Informationen zum QuorumLossWaitDuration-Parameter finden Sie unter StatefulServiceDescription.QuorumLossWaitDuration.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReplicaLifecycleDescription

Lebenszyklusbeschreibung von Replikaten, die zu diesem Dienst gehören. Wenn einige Konfigurationen in diesem Abschnitt nicht angegeben sind, wird der Standardwert vom Clusterparameter desselben Namens (sofern vorhanden) entnommen.

Typ:ReplicaLifecycleDescription
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ReplicaRestartWaitDuration

Gibt das aktualisierte Intervall als TimeSpan-Objekt an, auf das Service Fabric wartet, bis das Replikat neu gestartet wird, bevor ein Ersatzreplikat erstellt wird. Verwenden Sie das Cmdlet New-TimeSpan, um ein TimeSpan-Objekt abzurufen.

Weitere Informationen zu QuorumLossWaitDuration finden Sie unter StatefulServiceDescription.ReplicaRestartWaitDuration.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

Typ:System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceDnsName

Gibt den aktualisierten DNS-Namen eines Diensts an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ServiceName

Gibt den URI eines Service Fabric-Diensts an, dessen Eigenschaften aktualisiert werden müssen.

Typ:Uri
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ServicePlacementTimeLimit

Legt das Zeitlimit für die Dienstplatzierung fest.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StandByReplicaKeepDuration

Gibt die aktualisierte Stand-By-Replikatdauer als TimeSpan-Objekt an.

Weitere Informationen zu QuorumLossWaitDuration finden Sie unter StatefulServiceDescription.StandByReplicaKeepDuration.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Stateful

Gibt an, dass der Dienst ein Service Fabric-Zustandsdienst ist.

Typ:SwitchParameter
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Stateless

Gibt an, dass es sich bei dem Dienst um einen Service Fabric-Zustandslosen Dienst handelt.

Typ:SwitchParameter
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TagsRequiredToPlace

Deklariert Tags, die für die Platzierung eines Diensts erforderlich sind. Nützlich für die dynamische Beeinflussung der Dienstplatzierung. Weitere Informationen finden Sie unter Service Fabric Dynamic Node Tags.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TagsRequiredToRun

Deklariert Tags, die für die Platzierung und Ausführung eines Diensts erforderlich sind. Nützlich für die dynamische Beeinflussung der Dienstplatzierung und -ausführung. Weitere Informationen finden Sie unter Service Fabric Dynamic Node Tags

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TargetReplicaSetSize

Gibt die größe des aktualisierten Zielreplikats für einen Service Fabric-Zustandsdienst an. Weitere Informationen finden Sie unter StatefulServiceDescription.TargetReplicaSetSize.

Geben Sie diesen Parameter für einen zustandslosen Dienst nicht an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeoutSec

Gibt den Timeoutzeitraum in Sekunden für den Vorgang an.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

System.Uri

Ausgaben

System.Object