Add-DataGatewayClusterUser
Ajouter des autorisations utilisateur et associées au cluster
Syntaxe
Default (Par défaut)
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.
Propriétés du paramètre
| Type: | DatasourceType[] |
| Valeur par défaut: | None |
| 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 |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-GatewayClusterId
Cluster de passerelle auquel l’utilisateur doit être ajouté
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Groupe, Id |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-PrincipalObjectId
ID d’objet principal Azure Active Directory (AAD) (par exemple, ID utilisateur) à ajouter au cluster de passerelle
Propriétés du paramètre
| Type: | Guid |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Utilisateur |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | GatewayPrincipalRole |
| Valeur par défaut: | None |
| Valeurs acceptées: | Admin, ConnectionCreator, ConnectionCreatorWithReshare |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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
Propriétés du paramètre
| Type: | PowerBIUserScope |
| Valeur par défaut: | Individual |
| Valeurs acceptées: | Individual, Organization |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.