Update-ServiceFabricService

Modul:

ServiceFabric

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.

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

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

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

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

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

-Force

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Gibt den aktualisierten DNS-Namen eines Diensts an.

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

-ServiceName

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

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

-ServicePlacementTimeLimit

Legt das Zeitlimit für die Dienstplatzierung fest.

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

-StandByReplicaKeepDuration

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

Weitere Informationen zu QuorumLossWaitDuration finden Sie unter StatefulServiceDescription.StandByReplicaKeepDuration.

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

-Stateful

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

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

-Stateless

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

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

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

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

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

-TimeoutSec

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

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

-WhatIf

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

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

Eingaben

System.Uri

Ausgaben

System.Object

Ähnliche Themen

• Connect-ServiceFabricCluster
• Get-ServiceFabricClusterConnection
• Get-ServiceFabricService
• New-ServiceFabricService
• Remove-ServiceFabricService
• Resolve-ServiceFabricService