Add-PowerBIWorkspaceUser

參考

模組:: MicrosoftPowerBIMgmt.Workspaces

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

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

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

指派給使用者的許可權。

Type:	WorkspaceUserAccessRight
Aliases:	UserAccessRight
Accepted values:	Member, Admin, Contributor, Viewer
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

使用者應該加入的工作區識別碼。

Type:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Identifier

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

Type:	String
Aliases:	PrincipalId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PrincipalType

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

Type:	WorkspaceUserPrincipalType
Accepted values:	App, Group, User
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

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

Type:	PowerBIUserScope
Accepted values:	Individual, Organization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserPrincipalName

使用者主體名稱 (或 UPN，通常是需要新增許可權之使用者的電子郵件地址) 。

Type:	String
Aliases:	UserEmailAddress
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Workspace

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

Type:	Workspace
Aliases:	Group
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

None

輸出

System.Object

Share via