Add-DataGatewayClusterUser

  • Referenz
Modul:
DataGateway

Hinzufügen von Benutzern und zugeordneten Berechtigungen zum Cluster

Syntax

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

Beschreibung

Hinzufügen von Benutzern und zugeordneten 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 BenutzertestUpn@tenant.com "" in der Rolle "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 dem BenutzeradminTestUpn@tenant.com "" in der Rolle Admin zum Gatewaycluster für alle Datentypen hinzugefügt. Beachten Sie, dass der AllowedDataSourceTypes Wert null sein muss, wenn der Administrator der Rolle ist (bedeutet, dass alle Datenquellentypen zulässig sind).

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 dem BenutzeradminTestUpn@tenant.com "" in der Rolle Admin zum Gatewaycluster für alle Datentypen hinzugefügt. Beachten Sie, dass der AllowedDataSourceTypes Wert null sein muss, wenn der Administrator der Rolle ist (bedeutet, 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.

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 Admin zum Gatewaycluster für alle Datentypen hinzugefügt. Weitere Informationen finden Sie unter Get-AzADServicePrincipal. Beachten Sie, dass der Wert null sein muss, wenn die AllowedDataSourceTypes Rolle Administrator ist (imPlizieren aller Datentypen 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.

Parameter

-AllowedDataSourceTypes

Datentypen, die für diese Benutzer-/Rollenkombination zulässig sind. Dies muss null sein, wenn die Rolle Administrator ist(imPlizieren aller Datentypen sind zulässig). Die Liste des Datenquellentyps kann sich basierend auf unterstützten Datenquellen ändern. Hinweis: Dieser Parameter gilt nur für PowerApps und 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

Gatewaycluster, zu dem der Benutzer hinzugefügt werden soll

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)-Prinzipalobjekt-ID (d. h. Benutzer-ID) zum Hinzufügen zum Gatewaycluster

Type:Guid
Aliases:User
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RegionKey

Der Azure-Bereich, der dem angegebenen Gatewaycluster zugeordnet ist. Nicht bereitstellen wird -RegionKey der Befehl im Standardbereich für Ihren Mandanten ausgeführt. Um die Liste der verfügbaren Bereichsparameter abzurufen, führen Sie den Get-DataGatewayRegion Befehl aus.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Role

Rolle, die auf diesen Benutzer im Cluster angewendet werden soll. Benutzer können als Administratoren, Verbindungsautoren(Can Use) oder Connection Creators mit freigabe(Can use + Share) -Funktion hinzugefügt werden. Verbindungsautoren(Can Use) und Connection Creators with sharing(Can use + Share) feature apply only for PowerApps and Flow.

Type:GatewayPrincipalRole
Accepted values:Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

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

Type:PowerBIUserScope
Accepted values:Individual, Organization
Position:Named
Default value:Individual
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

System.Void