Update-ServiceFabricService
语法
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>]
说明
示例
示例 1:更新有状态服务
PS C:\> Update-ServiceFabricService -Stateful fabric:/myapp/test -MinReplicaSetSize 3 -TargetReplicaSetSize 5
此命令将正在运行的 Fabric 服务的 MinReplicaSetSize 和 TargetReplicaSetSize 更新为三 (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 |
声明放置服务所需的标记。 对于动态影响服务放置很有用。 有关详细信息,请参阅 Service Fabric 动态节点标记。
| 类型: | System.Collections.Generic.List`1[System.String]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
声明放置和运行服务所需的标记。 对于动态影响服务放置和运行很有用。 有关详细信息,请参阅 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