Restart-ServiceFabricDeployedCodePackage

모듈:

ServiceFabric

클러스터의 노드에 배포된 코드 패키지를 다시 시작하여 프로세스 오류를 시뮬레이션합니다.

Syntax

Restart-ServiceFabricDeployedCodePackage
       [-NodeName] <String>
       [-ApplicationName] <Uri>
       [-ServiceManifestName] <String>
       [-CodePackageName] <String>
       [[-CodePackageInstanceId] <Int64>]
       [-ServicePackageActivationId <String>]
       [-CommandCompletionMode <CompletionMode>]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -PartitionId <Guid>
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindSingleton]
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindNamed]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-PartitionKindUniformInt64]
       -PartitionKey <String>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-ReplicaKindPrimary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       [-ReplicaKindRandomSecondary]
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Restart-ServiceFabricDeployedCodePackage
       [-ApplicationName] <Uri>
       [-CommandCompletionMode <CompletionMode>]
       -ServiceName <Uri>
       -ReplicaOrInstanceId <Int64>
       [-TimeoutSec <Int32>]
       [<CommonParameters>]

Description

Restart-ServiceFabricDeployedCodePackage cmdlet은 코드 패키지 프로세스를 종료합니다. 그러면 해당 프로세스에서 호스트되는 모든 사용자 서비스 복제본이 다시 시작됩니다. 이 다시 시작은 서비스의 장애 조치(failover) 복구 경로를 테스트하는 클러스터의 코드 패키지 프로세스 실패를 시뮬레이션합니다.

코드 패키지를 지정하거나 ReplicaSelector를 지정하여 복제본이 호스트되는 노드 및 코드 패키지 조합을 다시 시작할 수 있습니다. 이렇게 하면 해당 노드를 다시 시작하기 전에 주 노드인 Service Fabric 노드를 확인할 필요가 없도록 하여 주 호스트 노드에서 테스트를 간소화할 수 있습니다.

Service Fabric 클러스터에서 작업을 수행하기 전에 Connect-ServiceFabricCluster cmdlet을 사용하여 클러스터에 대한 연결을 설정합니다.

예제

예제 1: 임의의 보조 복제본에 대한 코드 패키지 다시 시작

PS C:\> Restart-ServiceFabricDeployedCodePackage -ReplicaKindRandomSecondary -PartitionKindSingleton -ServiceName fabric:/SampleApp/SampleService -ApplicationName fabric:/SampleApp -CommandCompletionMode Verify

이 명령은 단일 파티션에서 임의의 보조 복제본에 대한 코드 패키지를 다시 시작합니다.

예제 2: 지정된 코드 패키지 다시 시작

PS C:\> Restart-ServiceFabricDeployedCodePackage -NodeName "Node01" -ApplicationName fabric:/App -CodePackageName "CodePackage01" -ServiceManifestName "ServiceManifest01" -CommandCompletionMode Verify

이 명령은 Node01 노드의 ServiceManifest01이라는 서비스 매니페스트에서 CodePackage01이라는 코드 패키지를 다시 시작합니다.

매개 변수

-ApplicationName

코드 패키지가 속한 애플리케이션의 이름을 지정합니다.

Type:	Uri
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CodePackageInstanceId

다시 시작하기 전에 배포된 패키지에 대해 검사되는 코드 패키지의 인스턴스 ID를 지정합니다. 0을 지정하면 비교가 수행되지 않습니다.

Type:	Int64
Position:	4
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-CodePackageName

다시 시작할 코드 패키지의 이름을 지정합니다.

Type:	String
Position:	3
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CommandCompletionMode

작업이 다시 시작이 완료되기를 기다리는지 여부를 지정합니다.

Type:	CompletionMode
Accepted values:	Invalid, DoNotVerify, Verify
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
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

코드 패키지를 다시 시작할 파티션의 ID를 지정합니다.

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PartitionKey

코드 패키지를 다시 시작하는 파티션의 키를 지정합니다.

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-PartitionKindNamed

이 cmdlet이 명명된 파티션에서 코드 패키지를 다시 시작한다는 것을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionKindSingleton

이 cmdlet이 단일 파티션에서 코드 패키지를 다시 시작한다는 것을 나타냅니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PartitionKindUniformInt64

이 cmdlet이 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를 지정합니다.

Type:	Int64
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceManifestName

코드 패키지가 정의된 서비스 매니페스트의 이름을 지정합니다.

Type:	String
Position:	2
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServiceName

코드 패키지가 속한 서비스의 이름을 지정합니다.

Type:	Uri
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-ServicePackageActivationId

CodePackage를 포함하는 배포된 ServicePackage의 활성화 ID입니다. Get-ServiceFabricDeployedCodePackage 쿼리를 사용하여 가져올 수 있습니다.

서비스를 만들 때 지정한 ServicePackageActivationMode가 New-ServiceFabricServiceSharedProcess(또는 지정되지 않은 경우 SharedProcess로 기본 설정)인 경우 ServicePackageActivationId의 값은 항상 빈 문자열이므로 지정할 필요가 없습니다. 서비스 패키지 활성화 ID에 대한 자세한 내용은 [Service Fabric 호스팅 모델][1]을 참조하세요.

Type:	String
Position:	Named
Default value:	None
Required:	False
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.Uri

System.Nullable`1[[System.Int64, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

System.Guid

출력

System.Object

관련 링크

• Connect-ServiceFabricCluster
• Get-ServiceFabricDeployedCodePackage