Add-DataGatewayClusterUser
클러스터에 사용자 및 관련 권한 추가
구문
Default (기본값)
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-AzADServicePrincipalAllowedDataSourceTypes null이어야 합니다(모든 데이터 원본 형식이 허용됨). 이 명령은 브라질 남부 지역에서 실행되므로 제공된 게이트웨이 클러스터 ID는 해당 지역에 있어야 합니다.
매개 변수
-AllowedDataSourceTypes
이 사용자/역할 조합에 허용되는 데이터 원본 형식입니다. 역할이 관리자인 경우 Null이어야 합니다(모든 데이터 원본 형식이 허용됨을 의미). 지원되는 데이터 원본에 따라 데이터 원본 형식 목록이 변경 될 수 있습니다. 참고: 이 매개 변수는 PowerApps 및 Flow에만 적용됩니다.
매개 변수 속성
| 형식: | DatasourceType[] |
| Default value: | None |
| 허용되는 값: | 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 |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-GatewayClusterId
사용자를 추가해야 하는 게이트웨이 클러스터
매개 변수 속성
| 형식: | Guid |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 클러스터, 아이디 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PrincipalObjectId
게이트웨이 클러스터에 추가할 AAD(Azure Active Directory) 보안 주체 개체 ID(예: 사용자 ID)
매개 변수 속성
| 형식: | Guid |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 사용자 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RegionKey
지정된 게이트웨이 클러스터와 연결된 Azure 지역입니다.
-RegionKey 제공하지 않으면 테넌트에 대한 기본 지역에서 명령이 실행됩니다.
사용 가능한 지역 매개 변수 목록을 얻으려면 Get-DataGatewayRegion 명령을 실행합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Role
클러스터에서 이 사용자에게 적용할 역할입니다. 사용자는 공유(사용 가능 + 공유) 기능을 사용하여 관리자, 연결 작성자(사용 가능) 또는 연결 작성자로 추가할 수 있습니다. 공유(사용 가능 + 공유) 기능을 사용하는 연결 작성자(사용 가능) 및 연결 작성자는 PowerApps 및 Flow에만 적용됩니다.
매개 변수 속성
| 형식: | GatewayPrincipalRole |
| Default value: | None |
| 허용되는 값: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Scope
명령을 실행할 보안 범위입니다. 이렇게 하면 테넌트/서비스 관리자 또는 게이트웨이 관리자의 범위에서 이 명령을 실행하는지 여부가 결정됩니다.
매개 변수 속성
| 형식: | PowerBIUserScope |
| Default value: | Individual |
| 허용되는 값: | Individual, Organization |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.