다음을 통해 공유


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>]

Description

Remove-ServiceFabricReplica cmdlet은 Service Fabric 클러스터에서 복제본을 제거하여 Service Fabric 복제본 오류를 시뮬레이션합니다. 제거는 복제본을 닫고 복제본을 None 역할로 전환한 다음 클러스터에서 복제본의 모든 상태 정보를 제거합니다. 이 cmdlet은 복제본 상태 제거 경로를 테스트하고 클라이언트 API를 통해 보고서 오류 영구 경로를 시뮬레이션합니다.

제거할 복제본을 지정하기 위해 노드 이름 또는 서비스 이름으로 시작할 수 있습니다.

그런 다음 복제본이 속한 파티션을 지정해야 합니다. 쌍(명명 체계, 파티션 키)을 지정하거나 파티션 ID를 지정하여 파티션을 지정할 수 있습니다. Microsoft Azure Service Fabric 분할에 대한 자세한 내용은 Partition 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
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceRemove

이 cmdlet이 복제본을 강제로 제거했음을 나타냅니다. ForceRemove사용하면 복제본 종료 시퀀스를 건너뛰고 복제본이 비정상적으로 제거됩니다. 상태 저장 서비스 복제본의 경우 영구 상태는 정리되지 않습니다. 복제본이 있는지 확인하려면 get-ServiceFabricReplica사용합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NodeName

Service Fabric 노드의 이름을 지정합니다. cmdlet은 지정한 노드에 배포된 복제본을 제거합니다.

형식:String
Position:0
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PartitionId

복제본을 제거할 파티션의 ID를 지정합니다.

형식:Guid
Position:1
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PartitionKey

파티션 키를 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PartitionKindNamed

이 cmdlet은 명명된 파티션에서 복제본을 제거한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PartitionKindSingleton

이 cmdlet은 싱글톤 파티션에서 복제본을 제거한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-PartitionKindUniformInt64

이 cmdlet은 UniformInt64 파티션에서 복제본을 제거한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ReplicaKindPrimary

이 cmdlet은 주 복제본에 대한 복제본을 제거한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ReplicaKindRandomSecondary

이 cmdlet은 임의의 보조 복제본에 대한 복제본을 제거한다는 것을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ReplicaOrInstanceId

Service Fabric 서비스 복제본 또는 인스턴스 ID를 지정합니다.

형식:Int64
Position:2
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ServiceName

제거할 서비스의 이름을 지정합니다.

형식:Uri
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-TimeoutSec

작업의 제한 시간(초)을 지정합니다.

형식:Int32
Position:Named
Default value: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