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>
이제 다음 표의 명령을 사용하여 게이트웨이 클러스터를 관리할 수 있습니다.
| 명령 | 설명 | 매개 변수 |
|---|---|---|
| Login-OnPremisesDataGateway | 이 명령을 사용하여 로그인하여 온-프레미스 데이터 게이트웨이 클러스터를 관리합니다. 다른 고가용성 명령이 제대로 작동 하려면 먼저 이 명령을 실행하고 로그인해야 합니다. 참고: 호출의 login 일부로 획득한 Microsoft Entra ID 인증 토큰은 만료된 후 1시간 동안만 유효합니다. 명령을 다시 실행 login 하여 새 토큰을 가져올 수 있습니다. |
Microsoft Entra ID 사용자 이름 및 암호(초기 호출이 아닌 명령 실행의 일부로 제공됨). |
| Get-OnPremisesDataGatewayClusters | 로그인한 사용자의 게이트웨이 클러스터 목록을 검색합니다. | 필요에 따라Format-Table -AutoSize -Wrap과 같이 가독성을 높이기 위해 서식 매개 변수를 이 명령에 전달할 수 있습니다. |
| Get-OnPremisesDataClusterGateways | 지정된 클러스터 내의 게이트웨이 목록과 온라인 또는 오프라인 상태 및 컴퓨터 이름과 같은 각 게이트웨이에 대한 추가 정보를 검색합니다. | -ClusterObjectID xyz ( 여기서 xyz 는 Get-OnPremisesDataGatewayClusters 명령을 사용하여 검색할 수 있는 실제 클러스터 개체 ID 값으로 대체됨). |
| Set-OnPremisesDataGateway | 이 명령을 사용하여 특정 게이트웨이 인스턴스를 사용하거나 사용하지 않도록 설정하는 기능을 포함하는 클러스터 내의 지정된 게이트웨이에 대한 속성 값을 설정합니다. |
-ClusterObjectID xyz ( 여기서 xyz 는 Get-OnPremisesDataGatewayClusters 명령을 사용하여 검색할 수 있는 실제 클러스터 개체 ID 값으로 대체됨). -GatewayObjectID abc ( 여기서 abc 는 클러스터 개체 ID가 지정된 경우 Get-OnPremisesDataClusterGateways 명령을 사용하여 검색할 수 있는 실제 게이트웨이 개체 ID 값으로 바뀝니다). |
| Get-OnPremisesDataGatewayStatus | 이 명령을 사용하여 클러스터 내에서 지정된 게이트웨이 인스턴스의 상태를 검색합니다. |
-ClusterObjectID xyz ( 여기서 xyz 는 Get-OnPremisesDataGatewayClusters 명령을 사용하여 검색할 수 있는 실제 클러스터 개체 ID 값으로 대체됨). -GatewayObjectID abc ( 여기서 abc 는 클러스터 개체 ID가 지정된 경우 Get-OnPremisesDataClusterGateways 명령을 사용하여 검색할 수 있는 실제 게이트웨이 개체 ID 값으로 바뀝니다). |
| Remove-OnPremisesDataGateway | 이 명령을 사용하여 클러스터에서 게이트웨이 인스턴스를 제거합니다. 참고: 클러스터의 다른 모든 게이트웨이가 제거될 때까지 클러스터의 기본 게이트웨이를 제거할 수 없습니다. |
-ClusterObjectID xyz ( 여기서 xyz 는 Get-OnPremisesDataGatewayClusters 명령을 사용하여 검색할 수 있는 실제 클러스터 개체 ID 값으로 대체됨). -GatewayObjectID abc ( 여기서 abc 는 클러스터 개체 ID가 지정된 경우 Get-OnPremisesDataClusterGateways 명령을 사용하여 검색할 수 있는 실제 게이트웨이 개체 ID 값으로 바뀝니다). |