Add-PowerBIWorkspaceUser

NAME Add-PowerBIWorkspaceUser



SYNOPSIS

Gives permissions to a specified user to access a Power BI workspace.





SYNTAX

Add-PowerBIWorkspaceUser -AccessRight {Member | Admin | Contributor} -Id <Guid> [-Scope {Individual |

Organization}] -UserPrincipalName <String> [<CommonParameters>]



Add-PowerBIWorkspaceUser -AccessRight {Member | Admin | Contributor} -Id <Guid> -Identifier <String>

-PrincipalType {App | Group | User} [-Scope {Individual | Organization}] [<CommonParameters>]



Add-PowerBIWorkspaceUser -AccessRight {Member | Admin | Contributor} -Identifier <String> -PrincipalType {App |

Group | User} [-Scope {Individual | Organization}] -Workspace <Workspace> [<CommonParameters>]



Add-PowerBIWorkspaceUser -AccessRight {Member | Admin | Contributor} [-Scope {Individual | Organization}]

-UserPrincipalName <String> -Workspace <Workspace> [<CommonParameters>]





DESCRIPTION

Grants permissions to a specified user to access a Power BI workspace using the provided inputs and scope

specified. Before you run this command, make sure you log in using Connect-PowerBIServiceAccount.





PARAMETERS

-AccessRight <WorkspaceUserAccessRight>

Permissions to assign to the user.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Id <Guid>

ID of the workspace the user should be added to.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Identifier <String>

Identifier of the principal to add to the group. For Apps and Groups, this will be their object identifier

(GUID). For users, this can be an email address.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-PrincipalType <WorkspaceUserPrincipalType>

The type of the principal to add to the group.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Scope <PowerBIUserScope>

Indicates scope of the call. Individual operates against only workspaces assigned to the caller; Organization

operates against all workspaces within a tenant (must be an administrator to initiate). Individual is the

default.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-UserPrincipalName <String>

User Principal Name (or UPN, commonly an email address) for the user whose permissions need to be added.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Workspace <Workspace>

The workspace entity to add the user to.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None







OUTPUTS

System.Object







NOTES









-------------------------- Example 1 --------------------------



PS C:\\> Add-PowerBIWorkspaceUser -Scope Organization -Id 23FCBDBD-A979-45D8-B1C8-6D21E0F4BE50 -UserEmailAddress

john@contoso.com -AccessRight Admin







RELATED LINKS

Online Version: https://docs.microsoft.com/en-us/powers ... werbiworks

paceuser?view=powerbi-ps