Update-ServiceFabricService

模組:

ServiceFabric

更新 Service Fabric 服務。

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

Description

Update-ServiceFabricService Cmdlet 會更新執行中 Service Fabric 服務的屬性。 可更新的屬性集是使用 或 New-ServiceFabricServiceFromTemplate) 建立服務 New-ServiceFabricService 時所指定的屬性子集 (。 您可以使用 Get-ServiceFabricServiceDescription 來取得服務的目前屬性。

請注意，更新執行中服務的屬性與使用 Start-ServiceFabricApplicationUpgrade升級您的服務不同。升級您的服務 (也就是應用程式) 是長時間執行的背景工作，牽涉到將應用程式從一個版本移至另一個版本，一次一個升級網域。 如需詳細資訊，請參閱 Service Fabric 應用程式升級 。

在 Service Fabric 叢集上執行任何作業之前，請先使用 Connect-ServiceFabricCluster Cmdlet 建立叢集的連線。

範例

範例 1：更新具狀態服務

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

此命令會將執行中網狀架構服務的 MinReplicaSetSize 和 TargetReplicaSetSize 更新為三個 (3) ，以及五個 (5) 。

範例 2：更新無狀態服務

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

此命令會將執行中的 Fabric Service 實例計數更新為 -1 的值。

範例 3：更新放置條件約束

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

此命令會更新放置條件約束。

範例 4：更新預設負載計量

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

第一個命令會更新無狀態服務的預設負載計量。

第二個命令會更新具狀態服務的預設負載計量。

範例 5：更新放置原則

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

此命令會更新放置原則。

範例 6：更新服務相互關聯

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

此命令會更新服務相互關聯。

範例 7：更新服務 DNS 名稱

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

此命令會更新服務的服務 DNS 名稱。 注意：如果在叢集上查詢更新的 DNS 名稱，或更新服務已經有 DNS 名稱，則更新後應該重新開機 DNS 服務，使快取失效。

參數

-Confirm

在執行 Cmdlet 前提示您確認。

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

-Correlation

指定此服務的相互關聯條件約束更新陣列。 若要深入瞭解服務相互關聯，請參閱 在 Service Fabric 中設定和使用服務親和性。

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

-DefaultMoveCost

指定複本建立時所擁有的更新預設移動成本。 此參數可接受的值為：

• 零個
• 低
• 中
• 高

如需移動成本的詳細資訊，請參閱影響叢集Resource Manager選擇的服務移動成本。

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

讓來源次要複本在新的次要複本完成建置之前卸載。

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

-Force

強制執行命令而不要求使用者確認。

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

-InstanceCloseDelayDuration

指定持續時間，以秒為單位，等待應用程式升級所影響的無狀態實例關閉，以允許作用中的要求正常清空。 此等候持續時間僅適用于針對 InstanceCloseDelayDuration 設定非零值的無狀態服務實例，而且會覆寫預先設定的值。 如需詳細資訊 ，請參閱 InstanceCloseDelayDuration 。 請勿為具狀態服務指定此參數。

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

-InstanceCount

指定 Service Fabric 無狀態服務的已更新實例數目。 請勿為具狀態服務指定此參數。

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

-InstanceLifecycleDescription

屬於此服務的實例生命週期描述。 如果未指定本節中的某些組態，如果現有的) ，預設值會取自相同名稱的叢集參數 (。

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

-InstanceRestartWaitDuration

當無狀態實例關閉時，此計時器就會啟動。 當 Service Fabric 到期時，會在叢集中的任何節點上建立新的實例。 此組態是減少在實例關閉時可能會短暫復原的情況下，不必要地建立新的實例。 例如，在升級期間。 預設值為 0，表示當無狀態實例關閉時，Service Fabric 會立即開始建置其取代專案。

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

-Metric

指定服務報告之計量的更新陣列。 若要深入瞭解計量，請參閱 使用計量管理 Service Fabric 中的資源耗用量和負載。

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

-MinInstanceCount

指定無狀態服務分割區的已更新實例數目下限。 如需詳細資訊，請參閱) 中的 New-ServiceFabricServiceMinInstanceCount (。 請勿為具狀態服務指定此參數。

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

-MinInstancePercentage

指定無狀態服務分割區 之 InstanceCount 的更新最小百分比。 如需詳細資訊，請參閱) 中的 New-ServiceFabricServiceMinInstancePercentage (。 請勿為具狀態服務指定此參數。

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

-MinReplicaSetSize

指定 Service Fabric 具狀態服務的更新最小複本集大小。 此值必須小於此服務的 TargetReplicaSetSize 。 如需詳細資訊，請參閱 StatefulServiceDescription.MinReplicaSetSize。

請勿為無狀態服務指定此參數。

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

指定服務的更新放置條件約束。 若要深入瞭解放置條件約束，請參閱 放置條件約束和節點屬性。

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

-PlacementPolicy

指定服務的已更新放置原則陣列。 若要深入瞭解 PlacementPolicy，請參閱 Service Fabric 服務的放置原則。

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

-QuorumLossWaitDuration

指定更新的持續時間，做為 TimeSpan 物件，Service Fabric 會在服務分割區宣告資料遺失之前先等候。

若要取得 TimeSpan 物件，請使用 New-TimeSpan Cmdlet。 如需詳細資訊，請鍵入 Get-Help New-TimeSpan。

若要深入瞭解 QuorumLossWaitDuration 參數，請參閱 StatefulServiceDescription.QuorumLossWaitDuration。

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

-ReplicaLifecycleDescription

屬於此服務的複本生命週期描述。 如果未指定本節中的某些組態，如果現有的) ，預設值會取自相同名稱的叢集參數 (。

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

-ReplicaRestartWaitDuration

指定更新的間隔，做為 TimeSpan 物件，Service Fabric 會在建立取代複本之前等候複本重新開機。 若要取得 TimeSpan 物件，請使用 New-TimeSpan Cmdlet。

若要深入瞭解 QuorumLossWaitDuration，請參閱 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

指定服務的更新 DNS 名稱。

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

-ServiceName

指定 Service Fabric 服務需要更新其屬性的 URI。

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

-ServicePlacementTimeLimit

設定服務放置時間限制。

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

-StandByReplicaKeepDuration

將更新的獨立複本保留持續時間指定為 TimeSpan 物件。

若要深入瞭解 QuorumLossWaitDuration，請參閱 StatefulServiceDescription.StandByReplicaKeepDuration。

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

-Stateful

表示服務是 Service Fabric 具狀態服務。

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

-Stateless

表示服務是 Service Fabric 無狀態服務。

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

-TagsRequiredToPlace

宣告放置服務時所需的標記。 適用於動態影響服務的放置。 如需詳細資訊，請參閱 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

宣告放置和執行服務時所需的標記。 適用於動態影響服務的放置和執行。 如需詳細資訊，請參閱 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

指定 Service Fabric 具狀態服務的更新目標複本集大小。 如需詳細資訊，請參閱 StatefulServiceDescription.TargetReplicaSetSize。

請勿為無狀態服務指定此參數。

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

-TimeoutSec

指定作業的逾時期間，以秒為單位。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 Cmdlet 並不會執行。

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

輸入

System.Uri

輸出

System.Object

相關連結

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