你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Restart-ServiceFabricNode
重启 Service Fabric 节点以模拟群集节点故障。
语法
Restart-ServiceFabricNode
[-NodeName] <String>
[[-NodeInstanceId] <BigInteger>]
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-PartitionId <Guid>
-ServiceName <Uri>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-PartitionId <Guid>
-ServiceName <Uri>
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-PartitionId <Guid>
-ServiceName <Uri>
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-PartitionId <Guid>
-ServiceName <Uri>
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindSingleton]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindNamed]
-PartitionKey <String>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindUniformInt64]
-PartitionKey <String>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindSingleton]
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindNamed]
-PartitionKey <String>
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindUniformInt64]
-PartitionKey <String>
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindSingleton]
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindNamed]
-PartitionKey <String>
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindUniformInt64]
-PartitionKey <String>
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindSingleton]
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindNamed]
-PartitionKey <String>
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-PartitionKindUniformInt64]
-PartitionKey <String>
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-ReplicaKindPrimary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
[-ReplicaKindRandomSecondary]
[-TimeoutSec <Int32>]
[<CommonParameters>]
Restart-ServiceFabricNode
[-CommandCompletionMode <CompletionMode>]
[-CreateFabricDump]
-ServiceName <Uri>
-ReplicaOrInstanceId <Int64>
[-TimeoutSec <Int32>]
[<CommonParameters>]
说明
Restart-ServiceFabricNode cmdlet 通过重启承载节点的 Fabric.exe 进程来重启 Service Fabric 节点。 此 cmdlet 模拟群集中的 Service Fabric 节点故障,该故障测试服务的故障转移恢复路径。 有关详细信息,请参阅 “使用测试操作”。
要重启的 Service Fabric 节点可以通过以下方式指定:
- 指定节点名称和(可选)节点实例 ID。
- 指定有状态服务副本或无状态服务实例,并让 cmdlet 标识并重启承载它的节点。 复制/实例选择的隐式行为值得注意:
- 如果服务不使用单一实例分区,并且未指定 PartitionId 和 PartitionKey 参数,则 cmdlet 会随机选取分区。
- 如果服务是有状态服务,并且未指定 Primary、 RandomSecondary 和 ReplicaOrInstanceId 参数,则该 cmdlet 会随机选取副本,而不考虑其角色。
- 如果服务是无状态服务且未指定 ReplicaOrInstanceId 参数,则 cmdlet 会随机选取实例。
如果为 NodeInstanceId 参数指定非零值,则此 ID 与活动节点 ID 进行比较。 如果 ID 不匹配,则进程不会重启,并且会发生错误。 过时的消息可能会导致此错误。
如果指定 CreateFabricDump 参数,此 cmdlet 将导致重启期间指定节点上的Fabric.exe进程崩溃。 此崩溃为Fabric.exe创建进程转储。
在 Service Fabric 群集上执行任何操作之前,请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。
示例
示例 1:重启承载主副本的节点
PS C:\> Restart-ServiceFabricNode -ReplicaKindPrimary -PartitionKindNamed -PartitionKey "Partition3" -CommandCompletionMode Verify
此命令重新启动承载名为 Partition3 的分区的主副本的节点。 由于 CommandCompletionMode 参数的指定值为 Verify,因此该命令会等待目标节点在完成之前重启。
示例 2:重启指定的节点
PS C:\> Restart-ServiceFabricNode -NodeName "Node01" -CommandCompletionMode DoNotVerify
此命令重新启动名为 Node01 的节点。 由于 CommandCompletionMode 参数的指定值为 DoNotVerify,因此该命令不会等待节点在完成之前重启。
参数
-CommandCompletionMode
指定操作是否等待重启完成。 指定 验证 以使 cmdlet 等待重启完成, DoNotVerify 使 cmdlet 返回,而无需等待重启完成。
Type: | CompletionMode |
Accepted values: | Invalid, DoNotVerify, Verify |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CreateFabricDump
指示应在指定节点上为Fabric.exe创建进程转储。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeInstanceId
指定节点实例 ID。
除非指定 0,否则指定的节点实例 ID 必须与当前正在运行的节点匹配。
若要获取节点实例 ID,请为目标节点运行 Get-ServiceFabricNode 。
例如,对于节点 N0050,该命令 Get-ServiceFabricNode -NodeName "N0050"
返回包含节点实例 ID 的 Node 对象。
Type: | BigInteger |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NodeName
指定 Service Fabric 节点的名称。 该 cmdlet 将重启指定的节点。
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PartitionId
指定 Service Fabric 服务分区的分区 ID。 该 cmdlet 重新启动承载此分区的副本或实例的节点。
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PartitionKey
指定 Service Fabric 服务分区的分区键。 该 cmdlet 标识此分区键映射到的分区,并重新启动承载该分区的副本或实例的节点。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PartitionKindNamed
指示 PartitionKey 参数为使用命名分区方案的服务指定分区键。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionKindSingleton
指示 ServiceName 参数中指定的服务使用单一实例分区。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PartitionKindUniformInt64
指示 PartitionKey 参数为使用 UniformInt64 分区方案的服务指定分区键。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplicaKindPrimary
指示此 cmdlet 重新启动承载指定分区的主副本的节点。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplicaKindRandomSecondary
指示此 cmdlet 重新启动承载指定分区的随机辅助副本的节点。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReplicaOrInstanceId
指定 Service Fabric 服务副本或实例 ID。 该 cmdlet 重新启动承载指定副本或实例的节点。
Type: | Int64 |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ServiceName
指定 Service Fabric 服务的名称。 该 cmdlet 重新启动承载此服务的副本或实例的节点。
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TimeoutSec
指定操作的超时时间段(以秒为单位)。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
System.String
System.Nullable`1[[System.Numerics.BigInteger, System.Numerics, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
System.Guid
System.Uri
System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]
输出
System.Object