Add-PowerBIWorkspaceUser
向指定用户授予访问 Power BI 工作区的权限。
语法
UserEmailWithId （默认值）
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>]
说明
使用指定的输入和范围向指定用户授予访问 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
|
| 默认值: | None |
| 接受的值: | Member, Admin, Contributor, Viewer |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | UserAccessRight |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Id
应将用户添加到的工作区的 ID。
参数属性
| 类型: | Guid
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | GroupId, WorkspaceId |
参数集
UserEmailWithId
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
PrincipalTypeWithId
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Identifier
要添加到组的主体的标识符。 对于应用和组，这是其对象标识符（GUID）。 对于用户，这可以是电子邮件地址。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | PrincipalId |
参数集
PrincipalTypeWithId
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
PrincipalTypeWithWorkspace
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-PrincipalType
要添加到组的主体的类型。
参数属性
| 类型: | WorkspaceUserPrincipalType
|
| 默认值: | None |
| 接受的值: | App, Group, User |
| 支持通配符: | False |
| 不显示: | False |
参数集
PrincipalTypeWithId
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
PrincipalTypeWithWorkspace
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Scope
指示调用的范围。 个人仅针对分配给调用方的工作区进行操作;组织针对租户中的所有工作区运行（必须是管理员才能启动）。 个人是默认值。
参数属性
| 类型: | PowerBIUserScope
|
| 默认值: | None |
| 接受的值: | Individual, Organization |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-UserPrincipalName
需要添加其权限的用户的用户主体名称（或 UPN，通常是电子邮件地址）。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 用户电子邮件地址 |
参数集
UserEmailWithId
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
UserEmailWithWorkspace
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Workspace
要向其添加用户的工作区实体。
参数属性
| 类型: | Workspace
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 组 |
参数集
UserEmailWithWorkspace
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
PrincipalTypeWithWorkspace
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
None
输出
System.Object