Add-DataGatewayClusterUser

Référence

Module:: DataGateway

Ajouter des autorisations utilisateur et associées au cluster

Syntax

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 montre comment ajouter l’utilisateur «adminTestUpn@tenant.com » dans le rôle de Administration au cluster de passerelle pour tous les types de sources de données. Notez que la AllowedDataSourceTypes valeur 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

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 de Administration au cluster de passerelle pour tous les types de sources de données. Pour plus d’informations, consultez Get-AzADServicePrincipal. Notez que la AllowedDataSourceTypes valeur 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. L’ID de cluster de passerelle fourni doit donc se trouver dans cette région.

Paramètres

-AllowedDataSourceTypes

Types de sources de données autorisés pour cette combinaison utilisateur/rôle. Cette valeur doit être null si le rôle est administrateur (ce qui implique 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[]
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

Cluster de passerelle auquel l’utilisateur doit être ajouté

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

-PrincipalObjectId

ID d’objet principal Azure Active Directory (AAD) (id d’utilisateur) à ajouter au cluster de passerelle

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

-RegionKey

Région Azure associée au cluster de passerelle spécifié. Si vous ne fournissez pas de -RegionKey commande, exécutez 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 Get-DataGatewayRegion commande

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 (peut utiliser) et les créateurs de connexions avec partage (peut utiliser + partager) s’appliquent uniquement à PowerApps et Flow.

Type:	GatewayPrincipalRole
Accepted values:	Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	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’une passerelle Administration

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

Entrées

None

Sorties

System.Void

Partager via