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

Det här exemplet lägger till 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

Det här exemplet lägger till användaren "adminTestUpn@tenant.com" i rollen Admin 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).

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

Det här exemplet lägger till användaren "adminTestUpn@tenant.com" i rollen Admin 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 DC8F2C49-9087-4B27-966B-3DB5094C2E77 i rollen som Admin till gatewayklustret för alla typer av datakällor. Mer information 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ällatyper 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.

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

Gatewaykluster som användaren ska läggas till i

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

-PrincipalObjectId

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

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

-RegionKey

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 delningsfunktioner (kan använda + dela) gäller endast för PowerApps och Flow.

Type:GatewayPrincipalRole
Accepted values:Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Säkerhetsomfång för att köra kommandot. Detta avgör om du kör det här kommandot i omfånget för en klientorganisation/tjänstadministratör eller en gateway-Admin

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

Indata

None

Utdata

System.Void