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