Add-DataGatewayClusterUser
Hinzufügen von Benutzer- und zugehörigen Berechtigungen zum Cluster
Syntax
Default (Standardwert)
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üden" ausgeführt, sodass sich die bereitgestellte Gatewaycluster-ID in dieser Region befinden 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üden" ausgeführt, sodass sich die bereitgestellte Gatewaycluster-ID in dieser Region befinden 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.
Parametereigenschaften
| Typ: | DatasourceType[] |
| Standardwert: | None |
| 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 |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-GatewayClusterId
Gatewaycluster, dem der Benutzer hinzugefügt werden soll
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Kluster, Id |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-PrincipalObjectId
Azure Active Directory (AAD)-Prinzipalobjekt-ID (d. h. Benutzer-ID), die dem Gatewaycluster hinzugefügt werden soll
Parametereigenschaften
| Typ: | Guid |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | Benutzer |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | GatewayPrincipalRole |
| Standardwert: | None |
| Zulässige Werte: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Scope
Sicherheitsbereich, um den Befehl auszuführen. Dies würde bestimmen, ob Sie diesen Befehl im Bereich eines Mandanten-/Dienstadministrators oder eines Gatewayadministrators ausführen.
Parametereigenschaften
| Typ: | PowerBIUserScope |
| Standardwert: | Individual |
| Zulässige Werte: | Individual, Organization |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.