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