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

Update-ServiceFabricService

更新 Service Fabric 服务。

语法

Stateless (默认值)

Update-ServiceFabricService
    [-ServiceName] <Uri>
    [-Stateless]
    [-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>]

Stateful

Update-ServiceFabricService
    [-ServiceName] <Uri>
    [-Stateful]
    [-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-ServiceFabricServiceNew-ServiceFabricServiceFromTemplate)。 可以使用 Get-ServiceFabricServiceDescription 获取服务的当前属性。

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

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

示例

示例 1:更新有状态服务

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

此命令将正在运行的 Fabric 服务的 MinReplicaSetSizeTargetReplicaSetSize 更新为三 (3) 和五 (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
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Correlation

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultMoveCost

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

  • 中等

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

参数属性

类型:String
默认值:None
接受的值:Zero, Low, Medium, High, VeryHigh
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DropSourceReplicaOnMove

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

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Force

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InstanceCloseDelayDuration

指定持续时间(以秒为单位),在关闭受应用程序升级影响的无状态实例之前等待,以允许活动请求正常清空。 此等待持续时间仅对那些为 InstanceCloseDelayDuration 配置了非零值的无状态服务的实例有效,并且将覆盖预配置的值。 有关详细信息,请参阅 InstanceCloseDelayDuration 。 不要为有状态服务指定此参数。

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

Stateless
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InstanceCount

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

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

Stateless
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InstanceLifecycleDescription

属于此服务的实例的生命周期描述。 如果未指定本节中的某些配置,则默认值将取自同名的集群参数(如果存在)。

参数属性

类型:InstanceLifecycleDescription
默认值:None
支持通配符:False
不显示:False

参数集

Stateless
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InstanceRestartWaitDuration

当无状态实例关闭时,此计时器将启动。 过期后,Service Fabric 将在群集中的任何节点上创建一个新实例。 此配置是为了减少在实例关闭可能会在短时间内恢复的情况下不必要地创建新实例。 例如,在升级期间。 默认值为 0,这表示当无状态实例关闭时,Service Fabric 将立即开始生成其替换实例。

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

Stateless
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Metric

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MinInstanceCount

指定无状态服务分区的更新最小实例数。 有关详细信息,请参阅 MinInstanceCount (in New-ServiceFabricService)。 不要为有状态服务指定此参数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

Stateless
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MinInstancePercentage

指定无状态服务分区的 InstanceCount 的更新最小百分比。 有关详细信息,请参阅 MinInstancePercentage (in New-ServiceFabricService)。 不要为有状态服务指定此参数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

Stateless
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MinReplicaSetSize

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

不要为无状态服务指定此参数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PartitionNamesToAdd

{{Fill PartitionNamesToAdd 描述}}

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PartitionNamesToRemove

{{Fill PartitionNamesToRemove 描述}}

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PlacementConstraints

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

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PlacementPolicy

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

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-QuorumLossWaitDuration

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

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

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

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ReplicaLifecycleDescription

属于此服务的副本的生命周期描述。 如果未指定本节中的某些配置,则默认值将取自同名的集群参数(如果存在)。

参数属性

类型:ReplicaLifecycleDescription
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ReplicaRestartWaitDuration

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

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

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ScalingPolicies

{{填写扩展策略说明}}

参数属性

类型:

System.Collections.Generic.List`1[System.Fabric.Description.ScalingPolicyDescription]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ServiceDnsName

指定服务的更新 DNS 名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ServiceName

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

参数属性

类型:Uri
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-ServicePlacementTimeLimit

设置服务放置时间限制。

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-StandByReplicaKeepDuration

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

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

参数属性

类型:TimeSpan
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Stateful

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Stateless

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

Stateless
Position:0
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TagsRequiredToPlace

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

参数属性

类型:

System.Collections.Generic.List`1[System.String]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TagsRequiredToRun

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

参数属性

类型:

System.Collections.Generic.List`1[System.String]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TargetReplicaSetSize

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

不要为无状态服务指定此参数。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

Stateful
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-TimeoutSec

指定作的超时时间(以秒为单位)。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

System.Uri

输出

System.Object