온-프레미스 데이터 게이트웨이 클러스터에 대한 PowerShell 지원
PowerShell 스크립트는 PowerShell 갤러리에서 사용할 수 있습니다. 이 문서에서 설명하는 스크립트는 PowerShell 버전 5용입니다. PowerShell 버전 7을 사용하는 경우 온-프레미스 데이터 게이트웨이 관리를 위한 PowerShell Cmdlet을 참조하세요. PowerShell 스크립트를 사용하여 다음 작업을 수행할 수 있습니다.
- 사용자에게 제공되는 게이트웨이 클러스터 목록을 검색합니다.
- 클러스터에 등록된 게이트웨이 인스턴스 목록과 온라인 또는 오프라인 상태를 검색합니다.
- 클러스터 내 게이트웨이 인스턴스의 사용/사용 안 함 상태와 다른 게이트웨이 속성을 수정합니다.
- 게이트웨이 삭제
PowerShell 명령 실행
이 cmdlet을 설치하려면 승격된 PowerShell 세션에서 다음 명령을 실행합니다.
Install-Module -Name OnPremisesDataGatewayHAMgmt
다음 명령을 사용하여 전체 cmdlet 목록을 찾을 수 있습니다.
Get-Command -Module OnPremisesDataGateway*
예제와 설명은 cmdlet에 포함되어 있으며 다음 명령을 사용하여 액세스할 수 있습니다.
get-help <cmdlet-name>
이제 다음 표의 명령을 사용하여 게이트웨이 클러스터를 관리할 수 있습니다.
| Command | 설명 | 매개 변수 |
|---|---|---|
| Login-OnPremisesDataGateway | 온-프레미스 데이터 게이트웨이 클러스터를 관리하려면 이 명령을 사용하여 로그인합니다. 다른 고가용성 명령이 제대로 작동하려면 먼저 이 명령을 실행하고 로그인해야 합니다. 참고: 호출의 login 일부로 획득한 Microsoft Entra ID 인증 토큰은 만료된 후 1시간 동안만 유효합니다. 명령을 다시 실행 login 하여 새 토큰을 가져올 수 있습니다. |
Microsoft Entra ID 사용자 이름 및 암호(초기 호출이 아닌 명령 실행의 일부로 제공됨). |
| Get-OnPremisesDataGatewayClusters | 로그인한 사용자에 대한 게이트웨이 클러스터 목록을 검색합니다. | 필요에 따라 가독성을 높이기 위해 Format-Table -AutoSize -Wrap과 같은 형식 지정 매개 변수를 이 명령에 전달할 수 있습니다. |
| Get-OnPremisesDataClusterGateways | 지정된 클러스터 내부의 게이트웨이 목록과 각 게이트웨이에 대한 추가 정보(온라인/오프라인 상태, 컴퓨터 이름 등)를 검색합니다. | -ClusterObjectID xyz(Get-OnPremisesDataGatewayClusters 명령으로 검색할 수 있는 실제 클러스터 개체 ID 값으로 xyz를 대체) |
| Set-OnPremisesDataGateway | 이 명령을 사용하여 특정 게이트웨이 인스턴스를 사용하거나 사용하지 않도록 설정하는 기능을 포함하여 클러스터 내 특정 게이트웨이의 속성 값을 설정할 수 있습니다. | -ClusterObjectID xyz(Get-OnPremisesDataGatewayClusters 명령으로 검색할 수 있는 실제 클러스터 개체 ID 값으로 xyz를 대체) -GatewayObjectID abc(클러스터 개체 ID가 지정된 경우 Get-OnPremisesDataClusterGateways 명령으로 검색할 수 있는 실제 게이트웨이 개체 ID 값으로 abc를 대체)입니다. |
| Get-OnPremisesDataGatewayStatus | 이 명령을 사용하면 클러스터 내의 특정 게이트웨이 인스턴스 상태를 검색할 수 있습니다. | -ClusterObjectID xyz(Get-OnPremisesDataGatewayClusters 명령으로 검색할 수 있는 실제 클러스터 개체 ID 값으로 xyz를 대체) -GatewayObjectID abc(클러스터 개체 ID가 지정된 경우 Get-OnPremisesDataClusterGateways 명령으로 검색할 수 있는 실제 게이트웨이 개체 ID 값으로 abc를 대체)입니다. |
| Remove-OnPremisesDataGateway | 클러스터에서 게이트웨이 인스턴스를 제거하려면 이 명령을 사용합니다. 참고: 클러스터의 다른 게이트웨이가 모두 제거될 때까지 클러스터의 기본 게이트웨이를 제거할 수 없습니다. | -ClusterObjectID xyz(Get-OnPremisesDataGatewayClusters 명령으로 검색할 수 있는 실제 클러스터 개체 ID 값으로 xyz를 대체) -GatewayObjectID abc(클러스터 개체 ID가 지정된 경우 Get-OnPremisesDataClusterGateways 명령으로 검색할 수 있는 실제 게이트웨이 개체 ID 값으로 abc를 대체)입니다. |