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」新增至所有數據源類型的閘道叢集。請注意，當角色為 admin 時，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」新增至所有數據源類型的閘道叢集。請注意，當角色為 admin 時，AllowedDataSourceTypes 必須是 null（表示允許所有數據源類型）。此命令會在巴西南部區域執行，因此提供的閘道叢集標識碼應該位於該區域。

範例 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

本範例會將應用程式標識符的服務主體新增至所有數據源類型之閘道叢集的角色DC8F2C49-9087-4B27-966B-3DB5094C2E77。如需詳細資訊，請參閱 get-AzADServicePrincipal。請注意，當角色為 admin 時，AllowedDataSourceTypes 必須是 null（表示允許所有數據源類型）。此命令會在巴西南部區域執行，因此提供的閘道叢集標識碼應該位於該區域。

參數

-AllowedDataSourceTypes

此使用者/角色組合所允許的數據來源類型。如果角色是 admin（表示允許所有數據源類型），則必須為 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
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-GatewayClusterId

應將使用者新增至其中的閘道叢集

類型:	Guid
別名:	Cluster, Id
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PrincipalObjectId

要新增至閘道叢集的 Azure Active Directory （AAD）主體物件識別碼（亦即使用者識別符）

類型:	Guid
別名:	User
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-RegionKey

與指定閘道叢集相關聯的 Azure 區域。未提供 -RegionKey 會在租用戶的預設區域中執行命令。若要取得可用區域參數的清單，請執行 Get-DataGatewayRegion 命令

類型:	String
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-Role

要套用至叢集上此使用者的角色。使用者可以新增為系統管理員、連線建立者（可以使用）或具有共用的連線建立者（可以使用 + 共用）功能。線上建立者（可以使用）和具有共用的連線建立者（可以使用 + 共用）功能僅適用於 PowerApps 和 Flow。

類型:	GatewayPrincipalRole
接受的值:	Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Scope

要執行命令的安全性範圍。這會判斷您是否在租使用者/服務管理員或閘道管理員的範圍內執行此命令

類型:	PowerBIUserScope
接受的值:	Individual, Organization
Position:	Named
預設值:	Individual
必要:	False
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

System.Void

共用方式為