Restore-PowerBIWorkspace

还原已删除的 Power BI 工作区。

语法

Restore-PowerBIWorkspace
       [-Scope <PowerBIUserScope>]
       -Id <Guid>
       [-RestoredName <String>]
       -AdminUserPrincipalName <String>
       [<CommonParameters>]
Restore-PowerBIWorkspace
       [-Scope <PowerBIUserScope>]
       [-RestoredName <String>]
       -AdminUserPrincipalName <String>
       -Workspace <Workspace>
       [<CommonParameters>]

说明

还原已删除的 Power BI 工作区,并将所有者设置为与指定电子邮件地址匹配的用户。 仅支持新工作区体验中的工作区,并且仅已删除尚未达到数据保留策略的已删除工作区才能完全删除。 仅支持 -Scope 组织,你必须拥有管理员权限(如 Office 365 全局管理员或 Power BI 服务管理员)才能调用此命令。 在使用 Connect-PowerBIServiceAccount 之前,必须先登录。

示例

示例 1

PS C:\> Restore-PowerBIWorkspace -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -RestoredName "TestWorkspace" -AdminEmailAddress "john@contoso.com"

还原具有指定 ID 的工作区,将具有指定电子邮件地址的用户分配为管理员,并将工作区的名称更新为指定名称。

参数

-AdminUserPrincipalName

将成为已还原工作区管理员的用户的用户主体名称(或 UPN,通常是电子邮件地址)。

类型:String
别名:AdminEmailAddress
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Id

要还原的工作区的 ID。

类型:Guid
别名:GroupId, WorkspaceId
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-RestoredName

要提供给还原工作区的可选新名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Scope

指示调用的范围。 不支持个人;除非工作区满足其数据保留策略并完成删除,否则组织可以还原租户内的任何已删除工作区(必须是管理员才能启动)。 组织是默认值。

类型:PowerBIUserScope
接受的值:Individual, Organization
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Workspace

要还原的工作区实体。

类型:Workspace
别名:Group
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

输入

System.Guid

输出

System.Object