Add-PowerBIWorkspaceUser

參考

模組:: MicrosoftPowerBIMgmt.Workspaces

授與指定使用者存取 Power BI 工作區的許可權。

語法

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

使用指定的輸入和範圍，將許可權授與指定的使用者，以存取 Power BI 工作區。執行此命令之前，請確定您使用 Connect-PowerBIServiceAccount 登入。

範例

範例 1

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

參數

-AccessRight

指派給用戶的許可權。

類型:	WorkspaceUserAccessRight
別名:	UserAccessRight
接受的值:	Member, Admin, Contributor, Viewer
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Id

用戶應加入的工作區標識碼。

類型:	Guid
別名:	GroupId, WorkspaceId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Identifier

要新增至群組之主體的標識碼。針對應用程式和群組，這會是其物件標識碼（GUID）。對於使用者，這可以是電子郵件位址。

類型:	String
別名:	PrincipalId
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-PrincipalType

要加入至群組的主體類型。

類型:	WorkspaceUserPrincipalType
接受的值:	App, Group, User
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Scope

表示呼叫的範圍。個人只會針對指派給呼叫者的工作區運作;組織會針對租使用者內的所有工作區運作（必須是系統管理員才能起始）。個人是預設值。

類型:	PowerBIUserScope
接受的值:	Individual, Organization
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-UserPrincipalName

需要新增許可權的用戶主體名稱（或 UPN，通常是電子郵件位址）。

類型:	String
別名:	UserEmailAddress
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

-Workspace

要新增使用者的工作區實體。

類型:	Workspace
別名:	Group
Position:	Named
預設值:	None
必要:	True
接受管線輸入:	False
接受萬用字元:	False

輸入

None

輸出

System.Object

共用方式為