Add-DataGatewayClusterUser

Reference

Modul:: DataGateway

Přidání uživatele a přidružených oprávnění ke clusteru

Syntaxe

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

Description

Přidání uživatele a přidružených oprávnění ke clusteru

Příklady

Příklad 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

Tento příklad přidá uživateletestUpn@tenant.comv roli ConnectionCreatorWithReshare do clusteru brány pro typy zdrojů dat SQL.

Příklad 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

Tento příklad přidá uživatele "adminTestUpn@tenant.com" v roli správce do clusteru brány pro všechny typy zdrojů dat. Všimněte si, že AllowedDataSourceTypes musí mít hodnotu null, pokud je role správce (což znamená, že jsou povoleny všechny typy zdrojů dat).

Příklad 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

Příklad 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

Tento příklad přidá instanční objekt pro ID aplikace DC8F2C49-9087-4B27-966B-3DB5094C2E77 v roli Správce do clusteru brány pro všechny typy zdrojů dat. Další informace najdete v tématu Get-AzADServicePrincipal. Mějte na paměti, že AllowedDataSourceTypes musí mít hodnotu null, pokud je role správce (což znamená, že jsou povoleny všechny typy zdrojů dat). Tento příkaz se spustí v oblasti Brazílie – jih, takže ZADANÉ ID clusteru brány by mělo být v této oblasti.

Parametry

-AllowedDataSourceTypes

Typy zdrojů dat, které jsou povoleny pro tuto kombinaci uživatele nebo role. Tato hodnota musí mít hodnotu null, pokud je role správce (což znamená, že jsou povolené všechny typy zdrojů dat). Seznam typů zdrojů dat se může změnit na základě podporovaných zdrojů dat. Poznámka: Tento parametr platí jenom pro PowerApps a Flow.

Typ:	DatasourceType[]
Přípustné hodnoty:	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
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-GatewayClusterId

Cluster brány, do kterého se má uživatel přidat

Typ:	Guid
Aliasy:	Cluster, Id
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-PrincipalObjectId

ID instančního objektu Azure Active Directory (AAD) (tj. ID uživatele) pro přidání do clusteru brány

Typ:	Guid
Aliasy:	User
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-RegionKey

Oblast Azure přidružená k zadanému clusteru brány. Nezadávejte -RegionKey spustí příkaz ve výchozí oblasti vašeho tenanta. Pokud chcete získat seznam dostupných parametrů oblasti, spusťte příkaz Get-DataGatewayRegion.

Typ:	String
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Role

Role, která se má použít pro tohoto uživatele v clusteru Uživatele je možné přidávat jako správce, tvůrce připojení (můžou používat) nebo Tvůrce připojení se sdílením (může používat + sdílet). Tvůrci připojení (můžou používat) a tvůrci připojení se sdílením (Může používat + Sdílet) platí jenom pro PowerApps a Flow.

Typ:	GatewayPrincipalRole
Přípustné hodnoty:	Admin, ConnectionCreator, ConnectionCreatorWithReshare
Position:	Named
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Scope

Obor zabezpečení pro spuštění příkazu. Tím zjistíte, jestli tento příkaz spouštíte v oboru správce tenanta nebo služby nebo správce brány.

Typ:	PowerBIUserScope
Přípustné hodnoty:	Individual, Organization
Position:	Named
Default value:	Individual
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

None

Výstupy

System.Void

Sdílet prostřednictvím