Freigeben über

Add-PowerBIWorkspaceUser

Modul:
MicrosoftPowerBIMgmt.Workspaces Module

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

Syntax

UserEmailWithId (Standardwert) 

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

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.

Parametereigenschaften

Typ:WorkspaceUserAccessRight
Standardwert:None
Zulässige Werte:Member, Admin, Contributor, Viewer
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:UserAccessRight

Parametersätze

(All)
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Id

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

Parametereigenschaften

Typ:Guid
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Gruppen-ID, WorkspaceId

Parametersätze

UserEmailWithId
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False
PrincipalTypeWithId
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:PrincipalId

Parametersätze

PrincipalTypeWithId
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
PrincipalTypeWithWorkspace
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PrincipalType

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

Parametereigenschaften

Typ:WorkspaceUserPrincipalType
Standardwert:None
Zulässige Werte:App, Group, User
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

PrincipalTypeWithId
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
PrincipalTypeWithWorkspace
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:PowerBIUserScope
Standardwert:None
Zulässige Werte:Individual, Organization
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-UserPrincipalName

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:BenutzerE-Mail-Adresse

Parametersätze

UserEmailWithId
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
UserEmailWithWorkspace
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Workspace

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

Parametereigenschaften

Typ:Workspace
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Gruppe

Parametersätze

UserEmailWithWorkspace
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False
PrincipalTypeWithWorkspace
Position:Named
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

System.Object