Add-DataGatewayClusterUser

참조

모듈:: DataGateway

클러스터에 사용자 및 관련 권한 추가

구문

Add-DataGatewayClusterUser
   [-Scope <PowerBIUserScope>]
   -GatewayClusterId <Guid>
   -PrincipalObjectId <Guid>
   [-AllowedDataSourceTypes <DatasourceType[]>]
   -Role <GatewayPrincipalRole>
   [-RegionKey <String>]
   [<CommonParameters>]

Description

클러스터에 사용자 및 관련 권한 추가

예제

예제 1

PS C:\> $userToAdd = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> $dsTypes = New-Object 'System.Collections.Generic.List[Microsoft.PowerBI.ServiceContracts.Api.DatasourceType]'
PS C:\> $dsTypes.Add([Microsoft.DataMovement.Powershell.GatewayClient.Gateways.Entities.DataSourceType]::Sql)
PS C:\> Add-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToAdd -AllowedDataSourceTypes $dsTypes -Role ConnectionCreatorWithReshare

다음은 ConnectionCreatorWithReshare 역할의 사용자 "testUpn@tenant.com"를 SQL 데이터 원본 형식의 게이트웨이 클러스터에 추가하는 예제입니다.

예제 2

PS C:\> $userToAdd = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Add-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToAdd -AllowedDataSourceTypes $null -Role Admin

다음은 관리자 역할의 "adminTestUpn@tenant.com" 사용자를 모든 데이터 원본 형식의 게이트웨이 클러스터에 추가하는 예제입니다. 역할이 관리자인 경우 AllowedDataSourceTypes null이어야 합니다(모든 데이터 원본 형식이 허용됨).

예제 3

PS C:\> $userToAdd = $(Get-AzADUser -ObjectId "testUpn@tenant.com").Id
PS C:\> Add-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToAdd -AllowedDataSourceTypes $null -Role Admin -RegionKey brazilsouth

다음은 관리자 역할의 "adminTestUpn@tenant.com" 사용자를 모든 데이터 원본 형식의 게이트웨이 클러스터에 추가하는 예제입니다. 역할이 관리자인 경우 AllowedDataSourceTypes null이어야 합니다(모든 데이터 원본 형식이 허용됨). 이 명령은 브라질 남부 지역에서 실행되므로 제공된 게이트웨이 클러스터 ID는 해당 지역에 있어야 합니다.

예제 4

PS C:\> $userToAdd = $(Get-AzADServicePrincipal -ApplicationId DC8F2C49-9087-4B27-966B-3DB5094C2E77).Id
PS C:\> Add-DataGatewayClusterUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -PrincipalObjectId $userToAdd -AllowedDataSourceTypes $null -Role Admin -RegionKey brazilsouth

이 예제에서는 모든 데이터 원본 유형의 게이트웨이 클러스터에 관리자 역할의 애플리케이션 ID DC8F2C49-9087-4B27-966B-3DB5094C2E77에 대한 서비스 주체를 추가합니다. 자세한 내용은 get-AzADServicePrincipal참조하세요. 역할이 관리자인 경우 AllowedDataSourceTypes null이어야 합니다(모든 데이터 원본 형식이 허용됨). 이 명령은 브라질 남부 지역에서 실행되므로 제공된 게이트웨이 클러스터 ID는 해당 지역에 있어야 합니다.

매개 변수

-AllowedDataSourceTypes

이 사용자/역할 조합에 허용되는 데이터 원본 형식입니다. 역할이 관리자인 경우 Null이어야 합니다(모든 데이터 원본 형식이 허용됨을 의미). 지원되는 데이터 원본에 따라 데이터 원본 형식 목록이 변경 될 수 있습니다. 참고: 이 매개 변수는 PowerApps 및 Flow에만 적용됩니다.

형식:	DatasourceType[]
허용되는 값:	Sql, AnalysisServices, SAPHana, File, Folder, Oracle, Teradata, SharePointList, Web, OData, DB2, MySql, PostgreSql, Sybase, Extension, SAPBW, AzureTables, AzureBlobs, Informix, ODBC, Excel, SharePoint, PubNub, MQ, BizTalk, GoogleAnalytics, CustomHttpApi, Exchange, Facebook, HDInsight, AzureMarketplace, ActiveDirectory, Hdfs, SharePointDocLib, PowerQueryMashup, OleDb, AdoDotNet, R, LOB, Salesforce, CustomConnector, SAPBWMessageServer, AdobeAnalytics, Essbase, AzureDataLakeStorage, SapErp, UIFlow, CDPA, EventHub, Unknown
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-GatewayClusterId

사용자를 추가해야 하는 게이트웨이 클러스터

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

-PrincipalObjectId

게이트웨이 클러스터에 추가할 AAD(Azure Active Directory) 보안 주체 개체 ID(예: 사용자 ID)

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

-RegionKey

지정된 게이트웨이 클러스터와 연결된 Azure 지역입니다. -RegionKey 제공하지 않으면 테넌트에 대한 기본 지역에서 명령이 실행됩니다. 사용 가능한 지역 매개 변수 목록을 얻으려면 Get-DataGatewayRegion 명령을 실행합니다.

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

-Role

클러스터에서 이 사용자에게 적용할 역할입니다. 사용자는 공유(사용 가능 + 공유) 기능을 사용하여 관리자, 연결 작성자(사용 가능) 또는 연결 작성자로 추가할 수 있습니다. 공유(사용 가능 + 공유) 기능을 사용하는 연결 작성자(사용 가능) 및 연결 작성자는 PowerApps 및 Flow에만 적용됩니다.

형식:	GatewayPrincipalRole
허용되는 값:	Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:	Named
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-Scope

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

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

입력

None

출력

System.Void

다음을 통해 공유