Add-DataGatewayClusterUser

Referentie

Module:: DataGateway

Gebruikersmachtigingen en bijbehorende machtigingen toevoegen aan het cluster

Syntax

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 in 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 de rol van Beheer aan het gatewaycluster voor alle gegevensbrontypen. Opmerking: de AllowedDataSourceTypes waarde moet null zijn wanneer de rol beheerder is (wat inhoudt dat alle typen gegevensbronnen 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 toepassings-id DC8F2C49-9087-4B27-966B-3DB5094C2E77 toegevoegd in de rol van Beheer aan het gatewaycluster voor alle gegevensbrontypen. Zie Get-AzADServicePrincipal voor meer informatie. Houd er rekening mee dat de AllowedDataSourceTypes waarde null moet zijn wanneer de rol beheerder is (wat betekent dat alle typen gegevensbronnen 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 typen gegevensbronnen zijn toegestaan). De lijst met gegevensbrontypen kan worden gewijzigd op basis van ondersteunde gegevensbronnen. Opmerking: deze parameter is alleen van toepassing op PowerApps en 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

Gatewaycluster waaraan de gebruiker moet worden toegevoegd

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

-PrincipalObjectId

Azure Active Directory-principalobject-id (AAD) (d.w.w.v. gebruikers-id) die moet worden toegevoegd aan het gatewaycluster

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

-RegionKey

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Role

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 delen (kan +delen gebruiken). Verbindingsmakers (kunnen gebruiken) en verbindingsmakers met delen (kan +share gebruiken) zijn alleen van toepassing op PowerApps en Flow.

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

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

Invoerwaarden

None

Uitvoerwaarden

System.Void

Delen via