Add-DataGatewayClusterUser

Referens

Modul:: DataGateway

Lägga till användare och associerade behörigheter i klustret

Syntax

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

Description

Lägga till användare och associerade behörigheter i klustret

Exempel

Exempel 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

I det här exemplet läggs användaren "testUpn@tenant.com" i rollen ConnectionCreatorWithReshare till gatewayklustret för SQL-datakällor.

Exempel 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

Exempel 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

I det här exemplet läggs användaren "adminTestUpn@tenant.com" i rollen Administratör till gatewayklustret för alla typer av datakällor. Observera att AllowedDataSourceTypes måste vara null när rollen är administratör (vilket innebär att alla typer av datakällor tillåts). Det här kommandot körs i regionen Brasilien, södra, så det gatewaykluster-ID som tillhandahålls bör finnas i den regionen.

Exempel 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

Det här exemplet lägger till tjänstens huvudnamn för program-ID:t DC8F2C49-9087-4B27-966B-3DB5094C2E77 i rollen som administratör i gatewayklustret för alla typer av datakällor. Mer information finns i Get-AzADServicePrincipal. Observera att AllowedDataSourceTypes måste vara null när rollen är administratör (vilket innebär att alla typer av datakällor tillåts). Det här kommandot körs i regionen Brasilien, södra, så det gatewaykluster-ID som tillhandahålls bör finnas i den regionen.

Parametrar

-AllowedDataSourceTypes

Datakällatyper som tillåts för den här kombinationen av användare/roll. Detta måste vara null om rollen är administratör (vilket innebär att alla datakällstyper tillåts). Listan över datakällans typ kan ändras baserat på datakällor som stöds. Obs! Den här parametern gäller endast för PowerApps och Flow.

Typ:	DatasourceType[]
Godkända värden:	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
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-GatewayClusterId

Gatewaykluster som användaren ska läggas till i

Typ:	Guid
Alias:	Cluster, Id
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-PrincipalObjectId

Huvudobjekt-ID för Azure Active Directory (AAD) (dvs. användar-ID) som ska läggas till i gatewayklustret

Typ:	Guid
Alias:	User
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-RegionKey

Den Azure-region som är associerad med det angivna gatewayklustret. Om du inte anger en -RegionKey körs kommandot i standardregionen för din klientorganisation. Om du vill hämta listan över tillgängliga regionparametrar kör du kommandot Get-DataGatewayRegion

Typ:	String
Position:	Named
Standardvärde:	None
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Role

Roll som ska tillämpas på den här användaren i klustret. Användare kan läggas till som administratörer, anslutningsskapare (kan använda) eller anslutningsskapare med delningsfunktioner (kan använda + dela). Anslutningsskapare(kan använda) och anslutningsskapare med delning(kan använda + dela) gäller endast för PowerApps och Flow.

Typ:	GatewayPrincipalRole
Godkända värden:	Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:	Named
Standardvärde:	None
Obligatorisk:	True
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

-Scope

Säkerhetsomfattning för att köra kommandot. Detta skulle avgöra om du kör det här kommandot i omfånget för en klientorganisation/tjänstadministratör eller gatewayadministratör

Typ:	PowerBIUserScope
Godkända värden:	Individual, Organization
Position:	Named
Standardvärde:	Individual
Obligatorisk:	False
Godkänn pipeline-indata:	False
Godkänn jokertecken:	False

Indata

None

Utdata

System.Void

Dela via