你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-ServiceFabricService

模块:

ServiceFabric

汇报 Service Fabric 服务。

语法

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

说明

Update-ServiceFabricService cmdlet 更新正在运行的 Service Fabric 服务的属性。 可以更新的属性集是创建服务时指定的属性的子集， (使用 New-ServiceFabricService 或 New-ServiceFabricServiceFromTemplate) 。 可以使用 Get-ServiceFabricServiceDescription 获取服务的当前属性。

请注意，更新正在运行的服务的属性不同于使用 Start-ServiceFabricApplicationUpgrade 升级服务。升级服务 (，即应用程序) 是一项长时间运行的后台任务，涉及将应用程序从一个版本移动到另一个版本，一次一个升级域。 有关详细信息，请参阅 Service Fabric 应用程序升级 。

在 Service Fabric 群集上执行任何操作之前，请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。

示例

示例 1：更新有状态服务

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

此命令将正在运行的 Fabric 服务的 MinReplicaSetSize 和 TargetReplicaSetSize 更新为 3 (3) 和 5 (5) 。

示例 2：更新无状态服务

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

此命令将正在运行的 Fabric 服务的实例计数更新为值 -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 之前进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Correlation

指定此服务的已更新相关约束数组。 若要了解有关服务相关性的详细信息，请参阅 在 Service Fabric 中配置和使用服务相关性。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultMoveCost

指定副本在创建副本时具有的默认移动成本。 此参数的可接受值为：

• 零
• 低
• 中
• 高

有关移动成本的更多详细信息，请参阅服务移动成本，以影响群集资源管理器选择。

类型:	String
接受的值:	Zero, Low, Medium, High, VeryHigh
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DropSourceReplicaOnMove

在新的辅助副本完成生成之前，允许删除源辅助副本。

类型:	Boolean
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

强制运行命令而不要求用户确认。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InstanceCloseDelayDuration

指定持续时间（以秒为单位），等待应用程序升级影响的无状态实例关闭，以允许活动请求正常耗尽。 此等待持续时间仅适用于为 InstanceCloseDelayDuration 配置了非零值的无状态服务的实例，并且将覆盖预配置的值。 有关详细信息，请参阅 InstanceCloseDelayDuration 。 请勿为有状态服务指定此参数。

类型:	TimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InstanceCount

指定 Service Fabric 无状态服务的已更新实例数。 请勿为有状态服务指定此参数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InstanceLifecycleDescription

属于此服务的实例的生命周期说明。 如果未指定本节中的某些配置，则如果现有) ，则默认值取自同名群集参数 (。

类型:	InstanceLifecycleDescription
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InstanceRestartWaitDuration

当无状态实例关闭时，此计时器将启动。 当 Service Fabric 过期时，将在群集中的任何节点上创建新实例。 此配置可以减少在实例关闭时可能短期内恢复的新实例的不必要的创建。 例如，在升级期间。 默认值为 0，指示当无状态实例关闭时，Service Fabric 将立即开始生成其替换项。

类型:	TimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Metric

指定服务报告的指标的更新数组。 若要详细了解指标，请参阅 使用指标管理 Service Fabric 中的资源消耗和负载。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MinInstanceCount

指定已更新的无状态服务分区的最小实例数。 有关详细信息，请参阅) 中的 New-ServiceFabricServiceMinInstanceCount (。 请勿为有状态服务指定此参数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MinInstancePercentage

指定无状态服务分区的 InstanceCount 更新的最小百分比。 有关详细信息，请参阅) 中的 New-ServiceFabricServiceMinInstancePercentage (。 请勿为有状态服务指定此参数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MinReplicaSetSize

指定 Service Fabric 有状态服务的更新最小副本集大小。 该值必须小于此服务的 TargetReplicaSetSize 。 有关详细信息，请参阅 StatefulServiceDescription.MinReplicaSetSize。

请勿为无状态服务指定此参数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd Description}}

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove Description}}

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PlacementConstraints

指定服务的更新放置约束。 若要了解有关放置约束的详细信息，请参阅 放置约束和节点属性。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PlacementPolicy

指定服务的已更新放置策略数组。 若要了解有关 PlacementPolicy 的详细信息，请参阅 Service Fabric 服务的放置策略。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-QuorumLossWaitDuration

将更新的持续时间指定为 TimeSpan 对象，Service Fabric 在为服务分区声明数据丢失之前等待。

若要获取 TimeSpan 对象，请使用 New-TimeSpan cmdlet。 要了解详情，请键入 Get-Help New-TimeSpan。

若要了解有关 QuorumLossWaitDuration 参数的详细信息，请参阅 StatefulServiceDescription.QuorumLossWaitDuration。

类型:	TimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ReplicaLifecycleDescription

属于此服务的副本的生命周期说明。 如果未指定本节中的某些配置，则如果现有) ，则默认值取自同名群集参数 (。

类型:	ReplicaLifecycleDescription
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ReplicaRestartWaitDuration

将更新的间隔指定为 TimeSpan 对象，Service Fabric 在创建替换副本之前等待副本重启。 若要获取 TimeSpan 对象，请使用 New-TimeSpan cmdlet。

若要了解有关 QuorumLossWaitDuration 的详细信息，请参阅 StatefulServiceDescription.ReplicaRestartWaitDuration。

类型:	TimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ScalingPolicies

{{Fill ScalingPolicies Description}}

类型:	System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ServiceDnsName

指定服务的已更新 DNS 名称。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ServiceName

指定需要更新其属性的 Service Fabric 服务的 URI。

类型:	Uri
Position:	1
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-ServicePlacementTimeLimit

设置服务放置时间限制。

类型:	TimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StandByReplicaKeepDuration

将更新的独立副本保留持续时间指定为 TimeSpan 对象。

若要了解有关 QuorumLossWaitDuration 的详细信息，请参阅 StatefulServiceDescription.StandByReplicaKeepDuration。

类型:	TimeSpan
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Stateful

指示服务是 Service Fabric 有状态服务。

类型:	SwitchParameter
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Stateless

指示服务是 Service Fabric 无状态服务。

类型:	SwitchParameter
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-TagsRequiredToPlace

声明放置服务所需的标记。 用于动态影响服务放置。 有关详细信息，请参阅 Service Fabric 动态节点标记。

类型:	System.Collections.Generic.List`1[System.String]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TagsRequiredToRun

声明放置和运行服务所需的标记。 用于动态影响服务放置和运行。 有关详细信息，请参阅 Service Fabric 动态节点标记

类型:	System.Collections.Generic.List`1[System.String]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TargetReplicaSetSize

指定 Service Fabric 有状态服务的更新目标副本集大小。 有关详细信息，请参阅 StatefulServiceDescription.TargetReplicaSetSize。

请勿为无状态服务指定此参数。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-TimeoutSec

指定操作的超时时间段（以秒为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示在此 cmdlet 运行的情况下将会发生什么。 此 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

System.Uri

输出

System.Object

相关链接

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