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

Restart-ServiceFabricReplica

重启 Service Fabric 副本以模拟有状态服务副本重新打开。

语法

Restart-ServiceFabricReplica
       [-NodeName] <String>
       [-PartitionId] <Guid>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       [-PartitionId] <Guid>
       -ServiceName <Uri>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]
Restart-ServiceFabricReplica
       -ServiceName <Uri>
       [-ReplicaOrInstanceId] <Int64>
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

说明

Restart-ServiceFabricReplica cmdlet 通过重启持久服务副本、关闭副本,然后重新打开它来模拟服务副本失败。 使用此 cmdlet 测试服务,了解副本重新打开路径上的问题。 此 cmdlet 可帮助通过客户端 API 模拟报告错误临时路径。 此 cmdlet 仅适用于属于有状态持久化服务的副本。

若要指定要重启的副本,可以使用节点名称或服务名称启动。

然后,我们需要指定副本所属的分区。 可以通过指定对(命名方案、分区键)或指定分区 ID 来指定分区。 有关 azure Service Fabric 服务分区Microsoft的更多详细信息,请参阅 分区 Service Fabric Reliable Services

最后,我们可能需要指定我们引用的分区的副本,并且可以通过指定副本角色(主要副本或次要副本)或指定副本 ID 来完成。

在某些情况下,用户可能需要重启服务的随机分区/副本组合,而不是特定的分区/副本组合。 如果想要运行一组随机转换来模拟实际故障,这对于服务的可测试性非常有用。 例如,如果只提供此 cmdlet 的服务名称并省略分区和/或副本信息,则 cmdlet 会随机选择分区和副本故障。 请注意,所选分区或副本将仅属于指定的服务。

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

示例

示例 1:重启副本

PS C:\> Restart-ServiceFabricReplica -NodeName "Node07" -PartitionId 869dd2e9-fdda-42a5-ad96-4b71c795dfd3 -ReplicaOrInstanceId 12345098480948

此命令在指定分区上的 Node07 上重启副本。

示例 2:重启主副本

PS C:\> Restart-ServiceFabricReplica -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition1" -ServiceName fabric:/App/Service

此命令在指定的分区上重新启动主副本。

参数

-CommandCompletionMode

指定操作是否等待重启操作完成。

类型:CompletionMode
接受的值:Invalid, DoNotVerify, Verify
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-NodeName

指定 Service Fabric 节点的名称。 该 cmdlet 将重启在指定的节点上部署的副本。

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

-PartitionId

指定要为其重启副本的分区的 ID。

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

-PartitionKey

指定重新启动副本的分区的键。

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

-PartitionKindNamed

指示此 cmdlet 在命名分区上重启副本。

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

-PartitionKindSingleton

指示此 cmdlet 在单一实例分区上重启副本。

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

-PartitionKindUniformInt64

指示此 cmdlet 在 UniformInt64 分区上重启副本。

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

-ReplicaKindPrimary

指示此 cmdlet 重新启动主副本的副本。

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

-ReplicaKindRandomSecondary

指示此 cmdlet 为随机次要副本重启副本。

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

-ReplicaOrInstanceId

指定 Service Fabric 服务副本或实例 ID。

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

-ServiceName

指定 Service Fabric 服务的名称。

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

-TimeoutSec

指定操作的超时期限(以秒为单位)。

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

输入

System.String

System.Guid

System.Uri

System.Management.Automation.SwitchParameter

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

输出

System.Object