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

Restart-ServiceFabricNode

模块:

ServiceFabric

重启 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 会随机选取分区。
  • 如果服务是有状态服务，并且没有 主，则 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 参数指定了“验证”值，因此该命令将等待目标节点重启，然后才能完成。

示例 2：重启指定的节点

PS C:\> Restart-ServiceFabricNode -NodeName "Node01" -CommandCompletionMode DoNotVerify

此命令将重启名为 Node01 的节点。 由于 CommandCompletionMode 参数指定了 DoNotVerify 值，因此该命令不会等待节点在完成之前重启。

参数

-CommandCompletionMode

指定操作是否等待重启完成。 指定 验证 以使 cmdlet 等待重启完成，DoNotVerify 使 cmdlet 返回，而无需等待重启完成。

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

-CreateFabricDump

指示应在指定节点上为 Fabric.exe 创建进程转储。

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

-NodeInstanceId

指定节点实例 ID。 除非指定 0，否则指定的节点实例 ID 必须与当前正在运行的节点匹配。 若要获取节点实例 ID，请针对目标节点运行 Get-ServiceFabricNode。 例如，对于节点 N0050，命令 Get-ServiceFabricNode -NodeName "N0050" 返回包含节点实例 ID 的 Node 对象。

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

-NodeName

指定 Service Fabric 节点的名称。 该 cmdlet 将重启指定的节点。

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

-PartitionId

指定 Service Fabric 服务分区的分区 ID。 该 cmdlet 重新启动承载此分区的副本或实例的节点。

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

-PartitionKey

指定 Service Fabric 服务分区的分区键。 该 cmdlet 标识此分区键映射到的分区，并重新启动承载该分区的副本或实例的节点。

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

-PartitionKindNamed

指示 PartitionKey 参数指定使用命名分区方案的服务的分区键。

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

-PartitionKindSingleton

指示在 ServiceName 参数中指定的服务使用单一实例分区。

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

-PartitionKindUniformInt64

指示 PartitionKey 参数指定使用 UniformInt64 分区方案的服务的分区键。

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

-ReplicaKindPrimary

指示此 cmdlet 重新启动承载指定分区的主副本的节点。

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

-ReplicaKindRandomSecondary

指示此 cmdlet 重新启动承载指定分区的随机次要副本的节点。

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

-ReplicaOrInstanceId

指定 Service Fabric 服务副本或实例 ID。 该 cmdlet 重新启动承载指定副本或实例的节点。

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

-ServiceName

指定 Service Fabric 服务的名称。 该 cmdlet 重新启动承载此服务的副本或实例的节点。

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

-TimeoutSec

指定操作的超时期限（以秒为单位）。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	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

相关链接

• Connect-ServiceFabricCluster
• Disable-ServiceFabricNode
• Enable-ServiceFabricNode
• Get-ServiceFabricNode
• Start-ServiceFabricNodeTransition