Remove-PowerBIWorkspaceUser

删除指定用户对 Power BI 工作区的权限。

语法

Id (默认值)

Remove-PowerBIWorkspaceUser
    -Id <Guid>
    -UserPrincipalName <String>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

Workspace

Remove-PowerBIWorkspaceUser
    -UserPrincipalName <String>
    -Workspace <Workspace>
    [-Scope <PowerBIUserScope>]
    [<CommonParameters>]

说明

使用指定的输入和范围删除指定用户对 Power BI 工作区的权限。 运行此命令之前,请确保使用 Connect-PowerBIServiceAccount 登录。

示例

示例 1

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

在调用方组织中删除 ID 为 23FCBDBD-A979-45D8-B1C8-6D21E0F4BE50 的工作区上用户 john@contoso.com 的权限。

示例 2

PS C:\> Remove-PowerBIWorkspaceUser -Scope Individual -Id 23FCBDBD-A979-45D8-B1C8-6D21E0F4BE50 -UserEmailAddress john@contoso.com

删除 ID 为 23FCBDBD-A979-45D8-B1C8-6D21E0F4BE50 的工作区上 john@contoso.com 的权限,这是调用方拥有的工作盘。

参数

-Id

应从中删除用户的工作区的 ID。

参数属性

类型:Guid
默认值:None
支持通配符:False
不显示:False
别名:GroupId, WorkspaceId

参数集

Id
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Scope

指示调用的范围。 个人仅针对分配给调用方的工作区进行操作;组织针对租户中的所有工作区运行(必须是管理员才能启动)。 个人是默认值。

参数属性

类型:PowerBIUserScope
默认值:None
接受的值:Individual, Organization
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-UserPrincipalName

需要删除其权限的用户的用户主体名称(或 UPN,通常是电子邮件地址)。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:用户电子邮件地址

参数集

(All)
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Workspace

要从中删除用户的工作区实体。

参数属性

类型:Workspace
默认值:None
支持通配符:False
不显示:False
别名:

参数集

Workspace
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