Restart-ServiceFabricNode

모듈:

ServiceFabric

Service Fabric 노드를 다시 시작하여 클러스터 노드 오류를 시뮬레이션합니다.

Syntax

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

Description

Restart-ServiceFabricNode cmdlet은 노드를 호스트하는 Fabric.exe 프로세스를 다시 시작하여 Service Fabric 노드를 다시 시작합니다. 이 cmdlet은 서비스의 장애 조치(failover) 복구 경로를 테스트하는 클러스터의 Service Fabric 노드 오류를 시뮬레이션합니다. 자세한 내용은 테스트 작업 사용을 참조하세요.

다시 시작할 Service Fabric 노드는 다음과 같은 방법으로 지정할 수 있습니다.

• 노드 이름과 필요에 따라 노드 인스턴스 ID를 지정합니다.
• 상태 저장 서비스 복제본 또는 상태 비지방 서비스 인스턴스를 지정하고 cmdlet에서 호스트하는 노드를 식별하고 다시 시작하도록 합니다. 복제본/인스턴스 선택에 대한 암시적 동작은 다음과 같이 주목할 가치가 있습니다.
  • 서비스에서 Singleton 파티션을 사용하지 않고 PartitionId 및 PartitionKey 매개 변수를 지정하지 않은 경우 cmdlet은 임의로 파티션을 선택합니다.
  • 서비스가 상태 저장 서비스이고 Primary, RandomSecondary 및 ReplicaOrInstanceId 매개 변수가 지정되지 않은 경우 cmdlet은 해당 역할에 관계없이 임의로 복제본을 선택합니다.
  • 서비스가 상태 비저장 서비스이고 ReplicaOrInstanceId 매개 변수가 지정되지 않은 경우 cmdlet은 임의로 인스턴스를 선택합니다.

NodeInstanceId 매개 변수에 0이 아닌 값을 지정하면 해당 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 매개 변수에 지정된 서비스가 Singleton 파티션을 사용한다는 것을 나타냅니다.

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

관련 링크

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