Partager via


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