Add-DataGatewayClusterUser
Ajouter des autorisations utilisateur et associées au cluster
Syntaxe
Add-DataGatewayClusterUser
[-Scope <PowerBIUserScope>]
-GatewayClusterId <Guid>
-PrincipalObjectId <Guid>
[-AllowedDataSourceTypes <DatasourceType[]>]
-Role <GatewayPrincipalRole>
[-RegionKey <String>]
[<CommonParameters>]
Description
Ajouter des autorisations utilisateur et associées au cluster
Exemples
Exemple 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
Cet exemple ajoute l’utilisateur «testUpn@tenant.com» dans le rôle de ConnectionCreatorWithReshare au cluster de passerelle pour les types de sources de données SQL.
Exemple 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
Cet exemple ajoute l’utilisateur «adminTestUpn@tenant.com» dans le rôle d’administrateur au cluster de passerelle pour tous les types de sources de données.
Notez que le AllowedDataSourceTypes
doit être null lorsque le rôle est administrateur (ce qui implique que tous les types de sources de données sont autorisés).
Exemple 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
Cet exemple ajoute l’utilisateur «adminTestUpn@tenant.com» dans le rôle d’administrateur au cluster de passerelle pour tous les types de sources de données.
Notez que le AllowedDataSourceTypes
doit être null lorsque le rôle est administrateur (ce qui implique que tous les types de sources de données sont autorisés).
Cette commande est exécutée dans la région sud du Brésil, de sorte que l’ID de cluster de passerelle fourni doit se trouver dans cette région.
Exemple 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
Cet exemple ajoute le principal de service pour l’ID d’application DC8F2C49-9087-4B27-966B-3DB5094C2E77 dans le rôle d’administrateur au cluster de passerelle pour tous les types de sources de données. Pour plus d’informations, consultez Get-AzADServicePrincipal. Notez que le AllowedDataSourceTypes
doit être null lorsque le rôle est administrateur (ce qui implique que tous les types de sources de données sont autorisés). Cette commande est exécutée dans la région sud du Brésil, de sorte que l’ID de cluster de passerelle fourni doit se trouver dans cette région.
Paramètres
-AllowedDataSourceTypes
Types de sources de données autorisés pour cette combinaison utilisateur/rôle. Cela doit être null si le rôle est administrateur(impliquant que tous les types de sources de données sont autorisés). La liste du type de source de données peut changer en fonction des sources de données prises en charge. Remarque : ce paramètre s’applique uniquement à PowerApps et Flow.
Type: | DatasourceType[] |
Valeurs acceptées: | 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 |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-GatewayClusterId
Cluster de passerelle auquel l’utilisateur doit être ajouté
Type: | Guid |
Alias: | Cluster, Id |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-PrincipalObjectId
ID d’objet principal Azure Active Directory (AAD) (par exemple, ID utilisateur) à ajouter au cluster de passerelle
Type: | Guid |
Alias: | User |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-RegionKey
Région Azure associée au cluster de passerelle spécifié. Vous ne fournissez pas de -RegionKey
exécutera la commande dans la région par défaut de votre locataire.
Pour obtenir la liste des paramètres de région disponibles, exécutez la commande Get-DataGatewayRegion
Type: | String |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Role
Rôle à appliquer à cet utilisateur sur le cluster. Les utilisateurs peuvent être ajoutés en tant qu’administrateurs, créateurs de connexions (peut utiliser) ou créateurs de connexions avec partage (peut utiliser + partager). Les créateurs de connexions (peuvent utiliser) et les créateurs de connexions avec partage (peut utiliser + partager) s’appliquent uniquement à PowerApps et Flow.
Type: | GatewayPrincipalRole |
Valeurs acceptées: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | True |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-Scope
Étendue de sécurité pour exécuter la commande. Cela détermine si vous exécutez cette commande dans l’étendue d’un administrateur client/service ou d’un administrateur de passerelle
Type: | PowerBIUserScope |
Valeurs acceptées: | Individual, Organization |
Position: | Named |
Valeur par défaut: | Individual |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
Entrées
None
Sorties
System.Void