Add-DataGatewayClusterUser

Referentie

Module:: DataGateway

Gebruikersmachtigingen en bijbehorende machtigingen toevoegen aan het cluster

Syntaxis

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

Description

Gebruikersmachtigingen en bijbehorende machtigingen toevoegen aan het cluster

Voorbeelden

Voorbeeld 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 dit voorbeeld wordt de gebruiker 'testUpn@tenant.com' toegevoegd aan de rol ConnectionCreatorWithReshare aan het gatewaycluster voor SQL-gegevensbrontypen.

Voorbeeld 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

Voorbeeld 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 dit voorbeeld wordt de gebruiker 'adminTestUpn@tenant.com' toegevoegd aan het gatewaycluster voor alle gegevensbrontypen. Opmerking: de AllowedDataSourceTypes moet null zijn wanneer de rol beheerder is (wat inhoudt dat alle gegevensbrontypen zijn toegestaan). Deze opdracht wordt uitgevoerd in de regio Brazilië - zuid, dus de opgegeven gatewaycluster-id moet zich in die regio bevinden.

Voorbeeld 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 dit voorbeeld wordt de service-principal voor de toepassings-id DC8F2C49-9087-4B27-966B-3DB5094C2E77 toegevoegd aan het gatewaycluster voor alle gegevensbrontypen. Zie Get-AzADServicePrincipalvoor meer informatie. Houd er rekening mee dat de AllowedDataSourceTypes null moet zijn wanneer de rol beheerder is (wat impliceert dat alle gegevensbrontypen zijn toegestaan). Deze opdracht wordt uitgevoerd in de regio Brazilië - zuid, dus de opgegeven gatewaycluster-id moet zich in die regio bevinden.

Parameters

-AllowedDataSourceTypes

Gegevensbrontypen die zijn toegestaan voor deze combinatie van gebruikers/rollen. Dit moet null zijn als de rol beheerder is (wat impliceert dat alle gegevensbrontypen zijn toegestaan). De lijst met gegevensbrontypen kan worden gewijzigd op basis van ondersteunde gegevensbronnen. Opmerking: deze parameter geldt alleen voor PowerApps en Flow.

Type:	DatasourceType[]
Geaccepteerde waarden:	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
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-GatewayClusterId

Gatewaycluster waaraan de gebruiker moet worden toegevoegd

Type:	Guid
Aliassen:	Cluster, Id
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-PrincipalObjectId

Principal-id van Azure Active Directory (AAD) (bijvoorbeeld gebruikers-id) die moet worden toegevoegd aan het gatewaycluster

Type:	Guid
Aliassen:	User
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-RegionKey

De Azure-regio die is gekoppeld aan het opgegeven gatewaycluster. Als u geen -RegionKey op te geven, wordt de opdracht uitgevoerd in de standaardregio voor uw tenant. Voer de opdracht Get-DataGatewayRegion uit om de lijst met beschikbare regioparameters op te halen

Type:	String
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Role

De rol die moet worden toegepast op deze gebruiker in het cluster. Gebruikers kunnen worden toegevoegd als beheerders, verbindingsmakers (kan gebruiken) of verbindingsmakers met de mogelijkheid voor delen (kan + delen) gebruiken. Verbindingsmakers (kunnen gebruiken) en verbindingsmakers met delen (kan +delen) alleen van toepassing zijn op PowerApps en Flow.

Type:	GatewayPrincipalRole
Geaccepteerde waarden:	Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Scope

Beveiligingsbereik om de opdracht uit te voeren. Hiermee wordt bepaald of u deze opdracht uitvoert in het bereik van een tenant-/servicebeheerder of een gatewaybeheerder

Type:	PowerBIUserScope
Geaccepteerde waarden:	Individual, Organization
Position:	Named
Default value:	Individual
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

None

Uitvoerwaarden

System.Void

Delen via