Start-ServiceFabricNodeTransition
Service Fabric 클러스터 노드를 시작하거나 중지하는 작업을 시작합니다.
구문
Start-ServiceFabricNodeTransition
[-Stop]
-OperationId <Guid>
-NodeName <String>
-NodeInstanceId <BigInteger>
-StopDurationInSeconds <Int32>
[-TimeoutSec <Int32>]
[<CommonParameters>] Start-ServiceFabricNodeTransition
[-Start]
-OperationId <Guid>
-NodeName <String>
-NodeInstanceId <BigInteger>
[-TimeoutSec <Int32>]
[<CommonParameters>] Description
Start-ServiceFabricNodeTransition cmdlet은 Service Fabric 클러스터 노드를 시작하거나 중지하는 비동기 작업을 시작합니다.
Stop 매개 변수를 지정하면 Service Fabric 클러스터 노드가 중지됨 상태로 전환됩니다. 노드는 가상 머신이나 컴퓨터가 아닌 프로세스입니다. 노드가 중지된 후에도 가상 머신 또는 컴퓨터가 계속 실행됩니다. 중지된 상태에서 노드는 클러스터의 멤버가 아니며 서비스를 호스트할 수 없습니다. 중지된 노드는 다운 또는 오프라인 노드를 시뮬레이션합니다.
Start 매개 변수를 지정하면 중지된 노드가 시작됩니다.
이 cmdlet이 성공적으로 반환되면 시스템에서 작업을 수락했습니다. 그러나 작업이 완료되었음을 의미하지는 않습니다. 작업의 현재 상태에 대한 정보를 얻으려면 Get-ServiceFabricNodeTransitionProgress cmdlet을 실행합니다.
Start-ServiceFabricNodeTransition cmdlet은 사용되지 않는 Start-ServiceFabricNode 및 Stop-ServiceFabricNode cmdlet보다 선호됩니다. 이 cmdlet을 Start-ServiceFabricNode 및 Stop-ServiceFabricNode와 혼합하지 마십시오. Stop-ServiceFabricNode를 사용하여 노드가 이미 중지된 경우 Start-ServiceFabricNodeTransition을 사용하기 전에 Start-ServiceFabricNode를 사용하여 노드를 시작합니다. 그 때부터 Start-ServiceFabricNodeTransition을 사용합니다.
자세한 내용은 노드 시작 및 중지 노드 API를 노드 전환 API로 바꾸기를 참조하세요.
예제
예제 1: Service Fabric 노드 중지
PS C:\> Start-ServiceFabricNodeTransition -Stop -OperationId 097b03e3-760a-419c-9fce-e83f8cc0894b -NodeName N0050 -NodeInstanceId 131242467532403195 -StopDurationInSeconds 3600이 명령은 1시간 동안 Service Fabric 노드를 중지하는 작업을 시작합니다. 1시간이 지나면 노드가 자동으로 시작됩니다. OperationId 값을 추적합니다. Get-ServiceFabricNodeTransitionProgress를 실행하는 데 사용할 수 있습니다.
예제 2: Service Fabric 노드 시작
PS C:\> Start-ServiceFabricNodeTransition -Start -OperationId 6d1bf9a1-9733-4d83-be59-0acea3be57a7 -NodeName N0050 -NodeInstanceId 131242467532403195이 명령은 중지된 Service Fabric 노드를 시작하는 작업을 시작합니다.
매개 변수
-NodeInstanceId
이 cmdlet이 시작하거나 중지하는 노드 인스턴스의 ID를 지정합니다.
노드 인스턴스 ID를 가져오려면 대상 노드에 대해 Get-ServiceFabricNode 를 실행합니다.
예를 들어 노드 N0050의 경우 이 명령은 Get-ServiceFabricNode -NodeName "N0050" 노드 인스턴스 ID가 포함된 Node 개체를 반환합니다.
| 형식: | BigInteger |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NodeName
이 cmdlet이 시작하거나 중지하는 Service Fabric 노드의 이름을 지정합니다. 클러스터에서 Service Fabric 노드를 가져오려면 Get-ServiceFabricNode cmdlet을 실행합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-OperationId
작업을 식별하는 고유 ID를 지정합니다. 작업을 시작하는 이 cmdlet과 작업 진행률을 가져오는 Get-ServiceFabricNodeTransitionProgress에 동일한 값을 사용합니다.
| 형식: | Guid |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Start
이 cmdlet이 중지된 노드를 시작했음을 나타냅니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Stop
이 cmdlet이 실행 중인 노드를 중지했음을 나타냅니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-StopDurationInSeconds
중지할 작업이 완료된 후 중지된 노드를 중지된 상태로 유지하는 기간을 초 단위로 지정합니다. 이 시간이 지나면 노드가 자동으로 시작됩니다.
최소값은 600입니다. 최대값은 14400입니다.
중지 기간을 지정하려면 Stop 매개 변수를 지정해야 합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TimeoutSec
이 cmdlet에 대한 제한 시간 값(초)을 지정합니다.
중지된 노드가 중지된 상태로 유지되는 시간이 아닙니다. 노드가 중지되는 기간을 제어하려면 StopDurationInSeconds 매개 변수를 사용합니다.
| 형식: | Int32 |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
출력
System.Object