Add-PowerBIWorkspaceUser

Referenz

Modul:: MicrosoftPowerBIMgmt.Workspaces

Gewährt einem bestimmten Benutzer Berechtigungen für den Zugriff auf einen Power BI-Arbeitsbereich.

Syntax

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>]

Beschreibung

Gewährt einem bestimmten Benutzer Berechtigungen für den Zugriff auf einen Power BI-Arbeitsbereich mithilfe der angegebenen Eingaben und des angegebenen Bereichs. Bevor Sie diesen Befehl ausführen, stellen Sie sicher, dass Sie sich mit Connect-PowerBIServiceAccount anmelden.

Beispiele

Beispiel 1

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

Parameter

-AccessRight

Berechtigungen, die dem Benutzer zugewiesen werden sollen.

Typ:	WorkspaceUserAccessRight
Aliase:	UserAccessRight
Zulässige Werte:	Member, Admin, Contributor, Viewer
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Id

DIE ID des Arbeitsbereichs, dem der Benutzer hinzugefügt werden soll.

Typ:	Guid
Aliase:	GroupId, WorkspaceId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Identifier

Bezeichner des Prinzipals, der der Gruppe hinzugefügt werden soll. Bei Apps und Gruppen ist dies deren Objektbezeichner (GUID). Für Benutzer kann dies eine E-Mail-Adresse sein.

Typ:	String
Aliase:	PrincipalId
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PrincipalType

Der Typ des Prinzipals, der der Gruppe hinzugefügt werden soll.

Typ:	WorkspaceUserPrincipalType
Zulässige Werte:	App, Group, User
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Scope

Gibt den Bereich des Anrufs an. Einzelperson arbeitet nur mit Arbeitsbereichen, die dem Anrufer zugewiesen sind; Die Organisation funktioniert für alle Arbeitsbereiche innerhalb eines Mandanten (muss ein Administrator sein, der initiiert werden soll). Einzelperson ist die Standardeinstellung.

Typ:	PowerBIUserScope
Zulässige Werte:	Individual, Organization
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-UserPrincipalName

Benutzerprinzipalname (oder UPN, häufig eine E-Mail-Adresse) für den Benutzer, dessen Berechtigungen hinzugefügt werden müssen.

Typ:	String
Aliase:	UserEmailAddress
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Workspace

Die Arbeitsbereichsentität, der der Benutzer hinzugefügt werden soll.

Typ:	Workspace
Aliase:	Group
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

None

Ausgaben

System.Object

Freigeben über