Add-PowerBIWorkspaceUser

Module:

MicrosoftPowerBIMgmt.Workspaces Module

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

Syntaxis

UserEmailWithId (Standaard)

Add-PowerBIWorkspaceUser
    -Id <Guid>
    -UserPrincipalName <String>
    -AccessRight <WorkspaceUserAccessRight>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

PrincipalTypeWithId

Add-PowerBIWorkspaceUser
    -Id <Guid>
    -AccessRight <WorkspaceUserAccessRight>
    -PrincipalType <WorkspaceUserPrincipalType>
    -Identifier <String>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

UserEmailWithWorkspace

Add-PowerBIWorkspaceUser
    -UserPrincipalName <String>
    -AccessRight <WorkspaceUserAccessRight>
    -Workspace <Workspace>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

PrincipalTypeWithWorkspace

Add-PowerBIWorkspaceUser
    -AccessRight <WorkspaceUserAccessRight>
    -Workspace <Workspace>
    -PrincipalType <WorkspaceUserPrincipalType>
    -Identifier <String>
    [-Scope <PowerBIUserScope>]
    [<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.

Voorbeelden

Example 1

PS C:\> Add-PowerBIWorkspaceUser -Scope Organization -Id 23FCBDBD-A979-45D8-B1C8-6D21E0F4BE50 -UserEmailAddress john@contoso.com -AccessRight Admin

Parameters

-AccessRight

Permissions to assign to the user.

Parametereigenschappen

Type:	WorkspaceUserAccessRight
Default value:	None
Geaccepteerde waarden:	Member, Admin, Contributor, Viewer
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	UserAccessRight

Parametersets

(All)

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Id

ID of the workspace the user should be added to.

Parametereigenschappen

Type:	Guid
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	GroupId, WorkspaceId

Parametersets

UserEmailWithId

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

PrincipalTypeWithId

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Identifier

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.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	PrincipalId

Parametersets

PrincipalTypeWithId

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

PrincipalTypeWithWorkspace

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-PrincipalType

The type of the principal to add to the group.

Parametereigenschappen

Type:	WorkspaceUserPrincipalType
Default value:	None
Geaccepteerde waarden:	App, Group, User
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

PrincipalTypeWithId

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

PrincipalTypeWithWorkspace

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Scope

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.

Parametereigenschappen

Type:	PowerBIUserScope
Default value:	None
Geaccepteerde waarden:	Individual, Organization
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-UserPrincipalName

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

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	UserEmailAddress

Parametersets

UserEmailWithId

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

UserEmailWithWorkspace

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Workspace

The workspace entity to add the user to.

Parametereigenschappen

Type:	Workspace
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False
Aliassen:	Group

Parametersets

UserEmailWithWorkspace

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

PrincipalTypeWithWorkspace

Position:	Named
Verplicht:	True
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Invoerwaarden

None

Uitvoerwaarden

System.Object