Freigeben über


Add-DataGatewayClusterUser

Hinzufügen von Benutzer- und zugehörigen Berechtigungen zum Cluster

Syntax

Add-DataGatewayClusterUser
   [-Scope <PowerBIUserScope>]
   -GatewayClusterId <Guid>
   -PrincipalObjectId <Guid>
   [-AllowedDataSourceTypes <DatasourceType[]>]
   -Role <GatewayPrincipalRole>
   [-RegionKey <String>]
   [<CommonParameters>]

Beschreibung

Hinzufügen von Benutzer- und zugehörigen Berechtigungen zum Cluster

Beispiele

Beispiel 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

In diesem Beispiel wird der Benutzer "testUpn@tenant.com" in der Rolle von ConnectionCreatorWithReshare zum Gatewaycluster für SQL-Datenquellentypen hinzugefügt.

Beispiel 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

In diesem Beispiel wird der Benutzer "adminTestUpn@tenant.com" in der Rolle des Administrators zum Gatewaycluster für alle Datenquellentypen hinzugefügt. Beachten Sie, dass die AllowedDataSourceTypes null sein muss, wenn die Rolle "Administrator" ist (imPlizieren aller Datenquellentypen sind zulässig).

Beispiel 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

In diesem Beispiel wird der Benutzer "adminTestUpn@tenant.com" in der Rolle des Administrators zum Gatewaycluster für alle Datenquellentypen hinzugefügt. Beachten Sie, dass die AllowedDataSourceTypes null sein muss, wenn die Rolle "Administrator" ist (imPlizieren aller Datenquellentypen sind zulässig). Dieser Befehl wird in der Region Brasilien süd ausgeführt, sodass die bereitgestellte Gatewaycluster-ID in dieser Region enthalten sein sollte.

Beispiel 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

In diesem Beispiel wird der Dienstprinzipal für die Anwendungs-ID DC8F2C49-9087-4B27-966B-3DB5094C2E77 in der Rolle des Administrators zum Gatewaycluster für alle Datenquellentypen hinzugefügt. Weitere Informationen finden Sie unter Get-AzADServicePrincipal. Beachten Sie, dass die AllowedDataSourceTypes null sein muss, wenn die Rolle administrator ist (implizieren, dass alle Datenquellentypen zulässig sind). Dieser Befehl wird in der Region Brasilien süd ausgeführt, sodass die bereitgestellte Gatewaycluster-ID in dieser Region enthalten sein sollte.

Parameter

-AllowedDataSourceTypes

Datenquellentypen, die für diese Benutzer-/Rollenkombination zulässig sind. Dies muss null sein, wenn die Rolle "admin" ist(implizieren, dass alle Datenquellentypen zulässig sind). Die Liste des Datenquellentyps kann sich basierend auf unterstützten Datenquellen ändern. Hinweis: Dieser Parameter gilt nur für PowerApps und Flow.

Typ:DatasourceType[]
Zulässige Werte: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
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-GatewayClusterId

Gatewaycluster, dem der Benutzer hinzugefügt werden soll

Typ:Guid
Aliase:Cluster, Id
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PrincipalObjectId

Azure Active Directory (AAD)-Prinzipalobjekt-ID (d. h. Benutzer-ID), die dem Gatewaycluster hinzugefügt werden soll

Typ:Guid
Aliase:User
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RegionKey

Die Azure-Region, die dem angegebenen Gatewaycluster zugeordnet ist. Wenn Sie keine -RegionKey bereitstellen, wird der Befehl in der Standardregion für Ihren Mandanten ausgeführt. Führen Sie den Befehl Get-DataGatewayRegion aus, um die Liste der verfügbaren Regionsparameter abzurufen

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Role

Rolle, die auf diesen Benutzer im Cluster angewendet werden soll. Benutzer können als Administratoren, Verbindungsersteller(Kann verwenden) oder Verbindungsersteller mit Freigabefunktion (Kann + Freigabe) hinzugefügt werden. Verbindungsersteller(Kann verwenden) und Verbindungsersteller mit Freigabefunktion (Kann + Freigabe) nur für PowerApps und Flow gelten.

Typ:GatewayPrincipalRole
Zulässige Werte:Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Scope

Sicherheitsbereich zum Ausführen des Befehls. Dies würde bestimmen, ob Sie diesen Befehl im Bereich eines Mandanten-/Dienstadministrators oder eines Gatewayadministrators ausführen.

Typ:PowerBIUserScope
Zulässige Werte:Individual, Organization
Position:Named
Standardwert:Individual
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Void