Add-DataGatewayClusterUser

  • 참조
모듈:
DataGateway

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

Syntax

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에만 적용됩니다.

Type:DatasourceType[]
Accepted values: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GatewayClusterId

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

Type:Guid
Aliases:Cluster, Id
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PrincipalObjectId

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

Type:Guid
Aliases:User
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RegionKey

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Role

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

Type:GatewayPrincipalRole
Accepted values:Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

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

Type:PowerBIUserScope
Accepted values:Individual, Organization
Position:Named
Default value:Individual
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

None

출력

System.Void