Delen via


Add-PowerBIWorkspaceUser

Geeft machtigingen aan een opgegeven gebruiker voor toegang tot een Power BI-werkruimte.

Syntaxis

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

Description

Verleent machtigingen aan een opgegeven gebruiker voor toegang tot een Power BI-werkruimte met behulp van de opgegeven invoer en het opgegeven bereik. Voordat u deze opdracht uitvoert, moet u zich aanmelden met Connect-PowerBIServiceAccount.

Voorbeelden

Voorbeeld 1

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

Parameters

-AccessRight

Machtigingen om toe te wijzen aan de gebruiker.

Type:WorkspaceUserAccessRight
Aliassen:UserAccessRight
Geaccepteerde waarden:Member, Admin, Contributor, Viewer
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Id

De id van de werkruimte waaraan de gebruiker moet worden toegevoegd.

Type:Guid
Aliassen:GroupId, WorkspaceId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Identifier

Id van de principal die moet worden toegevoegd aan de groep. Voor apps en groepen is dit hun object-id (GUID). Voor gebruikers kan dit een e-mailadres zijn.

Type:String
Aliassen:PrincipalId
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PrincipalType

Het type principal dat moet worden toegevoegd aan de groep.

Type:WorkspaceUserPrincipalType
Geaccepteerde waarden:App, Group, User
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Geeft het bereik van de aanroep aan. Individueel werkt alleen voor werkruimten die zijn toegewezen aan de aanroeper; Organisatie werkt op alle werkruimten binnen een tenant (moet een beheerder zijn om te initiƫren). Individu is de standaardinstelling.

Type:PowerBIUserScope
Geaccepteerde waarden:Individual, Organization
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-UserPrincipalName

User Principal Name (of UPN, meestal een e-mailadres) voor de gebruiker waarvan de machtigingen moeten worden toegevoegd.

Type:String
Aliassen:UserEmailAddress
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Workspace

De werkruimte-entiteit waaraan de gebruiker moet worden toegevoegd.

Type:Workspace
Aliassen:Group
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Uitvoerwaarden

System.Object