다음을 통해 공유


Get-DataGatewayCluster

현재 사용자에 대한 게이트웨이 클러스터 가져오기

구문

Get-DataGatewayCluster
   [-Scope <PowerBIUserScope>]
   [-RegionKey <String>]
   [-GatewayClusterId <Guid>]
   [<CommonParameters>]

Description

지정된 클러스터 ID와 일치하고 현재 사용자가 관리자인 게이트웨이 클러스터를 가져옵니다. 클러스터 ID를 지정하지 않으면 사용자가 관리자인 모든 게이트웨이 클러스터가 반환됩니다.

예제

예제 1

PS C:\> Get-DataGatewayCluster

현재 사용자가 관리자인 모든 게이트웨이 클러스터를 가져옵니다.

예제 2

PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77

지정된 게이트웨이 클러스터 ID "DC8F2C49-5731-4B27-966B-3DB5094C2E77"에 대한 게이트웨이 클러스터 세부 정보를 가져옵니다.

예제 3

PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty MemberGateways

지정된 게이트웨이 클러스터 ID "DC8F2C49-5731-4B27-966B-3DB5094C2E77"과 연결된 각 멤버 게이트웨이에 대한 세부 정보를 가져옵니다.

예제 4

PS C:\> Get-DataGatewayCluster -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 | Select -ExpandProperty Permissions

게이트웨이 클러스터 "DC8F2C49-5731-4B27-966B-3DB5094C2E77"을 관리하거나 사용할 수 있는 권한이 있는 사용자 목록을 가져옵니다.

예제 5

PS C:\> Get-DataGatewayCluster -Scope Organization

조직 내의 모든 게이트웨이 클러스터를 가져옵니다. 참고: -Scope Organization 옵션이 작동하려면 O365 테넌트 관리자, Power Platform 관리자 또는 Power BI 관리자여야 합니다.

예제 6

PS C:\> Get-DataGatewayCluster -RegionKey brazilsouth

관리자이며 브라질 남부 지역에 연결된 게이트웨이 클러스터를 가져옵니다.

매개 변수

-GatewayClusterId

게이트웨이 클러스터에 고유한 ID

형식:Guid
별칭:Cluster, Id
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RegionKey

게이트웨이에 연결된 Azure 지역입니다. -RegionKey 제공되지 않으면 테넌트의 기본 Power BI 지역이 사용됩니다. 사용 가능한 지역 매개 변수 목록을 얻으려면 Get-DataGatewayRegion cmdlet을 실행합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Scope

명령을 실행할 보안 범위입니다. 이렇게 하면 테넌트/서비스 관리자 또는 게이트웨이 관리자의 범위에서 이 명령을 실행하는지 여부가 결정됩니다.

형식:PowerBIUserScope
허용되는 값:Individual, Organization
Position:Named
Default value:Individual
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

None

출력

Microsoft.DataMovement.Powershell.GatewayClient.Gateways.Entities.GatewayCluster