Restore-PowerBIWorkspace

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

语法

Id (默认值)

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

Workspace

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

说明

还原已删除的 Power BI 工作区,并将所有者设置为与指定电子邮件地址匹配的用户。 仅支持新工作区体验中的工作区,并且仅已删除尚未达到数据保留策略的已删除工作区才能完全删除。 仅支持 -Scope 组织,您必须具有适当的权限或角色(例如 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
默认值:None
支持通配符:False
不显示:False
别名:管理员电子邮件地址

参数集

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

-Id

要还原的工作区的 ID。

参数属性

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

参数集

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

-RestoredName

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

参数属性

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

参数集

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

-Scope

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

参数属性

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

参数集

(All)
Position:Named
必需:False
来自管道的值: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

输入

System.Guid

输出

System.Object