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

说明

使用指定的输入和范围向指定用户授予访问 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

应将用户添加到的工作区的 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

通过