Add-DataGatewayClusterUser

Referencia

Modul:: DataGateway

Felhasználó és társított engedélyek hozzáadása a fürthöz

Syntax

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

Description

Felhasználó és társított engedélyek hozzáadása a fürthöz

Példák

1\. példa

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

Ez a példa hozzáadja a "testUpn@tenant.com" felhasználót a ConnectionCreatorWithReshare szerepkörhöz az SQL-adatforrástípusok átjárófürtje számára.

2\. példa

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

Ez a példa hozzáadja a "" felhasználótadminTestUpn@tenant.com a Rendszergazda szerepkörhöz az átjárófürthöz az összes adatforrástípus esetében. Vegye figyelembe, hogy a AllowedDataSourceTypes szerepkör rendszergazdai szerepkör esetén null értékűnek kell lennie (ami azt jelenti, hogy minden adatforrástípus engedélyezve van).

3\. példa

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

4\. példa

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

Ez a példa hozzáadja a DC8F2C49-9087-4B27-966B-3DB5094C2E77 alkalmazásazonosító szolgáltatásnevét az átjárófürthöz az összes adatforrástípushoz tartozó Rendszergazda szerepkörében. További információ: Get-AzADServicePrincipal. Vegye figyelembe, hogy a AllowedDataSourceTypes szerepkör rendszergazdai szerepkör esetén null értékűnek kell lennie (ami azt jelenti, hogy minden adatforrástípus engedélyezve van). Ez a parancs a dél-brazíliai régióban fut, ezért a megadott átjárófürt-azonosítónak ebben a régióban kell lennie.

Paraméterek

-AllowedDataSourceTypes

Az ehhez a felhasználó-szerepkör kombinációhoz engedélyezett adatforrástípusok. Ennek null értékűnek kell lennie, ha a szerepkör rendszergazda (vagyis minden adatforrástípus engedélyezve van). Az adatforrástípusok listája a támogatott adatforrások alapján változhat. Megjegyzés: Ez a paraméter csak a PowerApps és a Flow esetében érvényes.

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

Átjárófürt, amelyhez a felhasználót hozzá kell adni

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

-PrincipalObjectId

Az Azure Active Directory (AAD) egyszerű objektumazonosítója (azaz felhasználói azonosítója) az átjárófürthöz hozzáadandó

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

-RegionKey

A megadott átjárófürthöz társított Azure-régió. Ha nem ad meg egy parancsot -RegionKey , akkor a parancs a bérlő alapértelmezett régiójában fut. Az elérhető régióparaméterek listájának lekéréséhez futtassa a Get-DataGatewayRegion parancsot

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

-Role

A felhasználóra a fürtön alkalmazandó szerepkör. A felhasználók hozzáadhatók rendszergazdaként, kapcsolatkészítőként (használhatja) vagy kapcsolatkészítőként a megosztási (használhatja + megosztás) képességekkel. A kapcsolatkészítők (használhatják) és a kapcsolatkészítők megosztási (használhatják + megosztási) képességekkel csak a PowerApps és a Flow szolgáltatásra vonatkoznak.

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

-Scope

Biztonsági hatókör a parancs futtatásához. Ez azt állapítja meg, hogy a parancsot bérlői/szolgáltatás-rendszergazdai vagy átjáró-Rendszergazda

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

Bevitelek

None

Kimenetek

System.Void

Share via