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

Remove-ServiceFabricReplica

从群集中删除副本以模拟副本故障。

语法

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

说明

Remove-ServiceFabricReplica cmdlet 通过从 Service Fabric 群集中删除副本来模拟 Service Fabric 副本故障。 删除会关闭副本,将副本转换为“无”角色,然后从群集中删除副本的所有状态信息。 此 cmdlet 测试副本状态删除路径,并通过客户端 API 模拟报告错误永久路径。

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

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

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

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

示例

示例 1:删除副本

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

在 Service Fabric 群集上执行任何操作之前,请使用 Connect-ServiceFabricCluster cmdlet 建立与群集的连接。 此命令删除属于指定节点上部署的指定分区的副本。

示例 2:删除主副本

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

此命令删除属于指定命名分区的主副本。

参数

-CommandCompletionMode

指定操作是否等待删除操作完成。

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

-ForceRemove

指示此 cmdlet 强制删除副本。 通过使用 ForceRemove,我们将跳过副本关闭序列,并且副本未正常删除。 对于有状态服务副本,不会清理其持久状态。 若要检查副本是否存在,请使用 Get-ServiceFabricReplica

类型:SwitchParameter
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

指定要删除的服务的名称。

类型: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