Add-DataGatewayClusterDatasourceUser

Reference

Module:: DataGateway

Grants a user permission to use the specified Power BI datasource.

Syntax

Add-DataGatewayClusterDatasourceUser
   -GatewayClusterId <Guid>
   -GatewayClusterDatasourceId <Guid>
   -DatasourceUserAccessRight <DatasourceUserAccessRight>
   -Identifier <Guid>
   [-UserEmailAddress <String>]
   [<CommonParameters>]

Add-DataGatewayClusterDatasourceUser
   -GatewayClusterId <Guid>
   -GatewayClusterDatasourceId <Guid>
   -DatasourceUserAccessRight <DatasourceUserAccessRight>
   [-Identifier <Guid>]
   -UserEmailAddress <String>
   [<CommonParameters>]

Description

Grants a user permission to use the specified Power BI datasource.

Examples

Example 1

PS C:\> Add-DataGatewayClusterDatasourceUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -GatewayClusterDatasourceId 64C574B7-86C6-4560-B710-40AC18990804 -DatasourceUserAccessRight Read -UserEmailAddress testEmail@tenant.com

Grants read access to 'testUpn@tenant.com' for the datasource.

Example 2

PS C:\> Add-DataGatewayClusterDatasourceUser -GatewayClusterId DC8F2C49-5731-4B27-966B-3DB5094C2E77 -GatewayClusterDatasourceId 64C574B7-86C6-4560-B710-40AC18990804 -DatasourceUserAccessRight Read -Identifier 8F4FD111-57EE-4E99-B65C-3DC0EFB1479D

Grants read access to principal with the given object id for the datasource.

Parameters

-DatasourceUserAccessRight

User permissions for this data source. It could either be Read or ReadOverrideEffectiveIdentity. Read permissions provides read access to the data source. ReadOverrideEffectiveIdentity indicates that the user can override effective identity for Power BI Embedded. For more information, see DatasourceUserAccessRight.

Type:	DatasourceUserAccessRight
Accepted values:	Read, ReadOverrideEffectiveIdentity
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-GatewayClusterDatasourceId

Data source to which the user is granted permissions for.

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

-GatewayClusterId

Gateway cluster to which the data source belongs.

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

-Identifier

Principal objectId of the user/group/service principal.

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

-UserEmailAddress

Email address of the user to be added

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

Inputs

None

Outputs

System.Void