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」 新增至所有數據源類型的閘道叢集。
請注意，當角色為 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[] |
| 預設值: | 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 |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-GatewayClusterId
應將使用者新增至其中的閘道叢集
參數屬性
| 類型: | Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 集群, 身份識別碼 |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-PrincipalObjectId
要新增至閘道叢集的 Azure Active Directory （AAD） 主體物件識別碼 （亦即使用者識別符）
參數屬性
| 類型: | Guid |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | 使用者 |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-RegionKey
與指定閘道叢集相關聯的 Azure 區域。 未提供 -RegionKey 會在租用戶的預設區域中執行 命令。
若要取得可用區域參數的清單，請執行 Get-DataGatewayRegion 命令
參數屬性
| 類型: | String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Role
要套用至叢集上此使用者的角色。 使用者可以新增為系統管理員、連線建立者（可以使用）或具有共用的連線建立者（可以使用 + 共用）功能。 線上建立者（可以使用）和具有共用的連線建立者（可以使用 + 共用）功能僅適用於 PowerApps 和 Flow。
參數屬性
| 類型: | GatewayPrincipalRole |
| 預設值: | None |
| 接受的值: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Scope
要執行命令的安全性範圍。 這會判斷您是否在租使用者/服務管理員或閘道管理員的範圍內執行此命令
參數屬性
| 類型: | PowerBIUserScope |
| 預設值: | Individual |
| 接受的值: | Individual, Organization |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。