Add-DataGatewayClusterUser

Reference

Modul:: DataGateway

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

Syntax

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živatele "testUpn@tenant.com" v 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živateleadminTestUpn@tenant.com v roli Správa do clusteru brány pro všechny typy zdrojů dat. Poznámka: Hodnota AllowedDataSourceTypes musí být null, pokud je role správcem (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áva do clusteru brány pro všechny typy zdrojů dat. Další informace najdete v tématu Get-AzADServicePrincipal. Všimněte si, že AllowedDataSourceTypes pokud je role správcem, musí mít hodnotu null (což znamená, že jsou povoleny všechny typy zdrojů dat). Tento příkaz se spustí v oblasti Brazílie – jih, takže ID clusteru brány by mělo být v dané oblasti.

Parametry

-AllowedDataSourceTypes

Typy zdrojů dat, které jsou povolené pro tuto kombinaci uživatele nebo role. Pokud je tato role správcem (což znamená, že jsou povolené všechny typy zdrojů dat), musí mít hodnotu null. 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.

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

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

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

-PrincipalObjectId

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

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

-RegionKey

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

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

-Role

Role, která se má použít pro tohoto uživatele v clusteru Uživatelé můžou být přidáni jako správci, tvůrci připojení (můžou používat) nebo tvůrci 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ůžou používat + Sdílet) platí jenom pro PowerApps a Flow.

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

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

Vstupy

None

Výstupy

System.Void

Sdílet prostřednictvím