Add-DataGatewayClusterUser
將使用者和相關聯的許可權新增至叢集
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) 。
此命令是在巴西南部區域中執行,因此提供的閘道叢集識別碼應該在該區域中。
範例 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。 請注意, AllowedDataSourceTypes
當角色是系統管理員 (表示允許所有資料來源類型時,必須是 null) 。 此命令是在巴西南部區域中執行,因此提供的閘道叢集識別碼應該在該區域中。
參數
-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
Azure Active Directory (AAD) 主體物件識別碼 (,也就是要新增至閘道叢集的使用者識別碼)
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