Set-PowerBIWorkspace

参考

模块:: MicrosoftPowerBIMgmt.Workspaces

更新 Power BI 工作区。

语法

Set-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   -Id <Guid>
   [-Name <String>]
   [-Description <String>]
   [<CommonParameters>]

Set-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   -Workspace <Workspace>
   [<CommonParameters>]

Set-PowerBIWorkspace
   [-Scope <PowerBIUserScope>]
   -Id <Guid>
   -CapacityId <Guid>
   [<CommonParameters>]

说明

更新 Power BI 工作区的名称或说明。仅支持新工作区体验预览中的工作区。仅支持 -Scope 组织，你必须拥有管理员权限（如 Office 365 全局管理员或 Power BI 服务管理员）才能调用此命令。运行此命令之前，请确保使用 Connect-PowerBIServiceAccount 登录。

示例

示例 1

PS C:\> Set-PowerBIWorkspace -Scope Organization -Id "3244f1c1-01cf-457f-9383-6035e4950fdc" -Name "Test Name" -Description "Test Description"

如果当前用户是管理员，则会更新与调用方组织中工作区的指定名称和说明值匹配的工作区。

示例 2

PS C:\> $workspaces = Get-PowerBIWorkspace -Scope Organization
PS C:\> $workspace = $workspaces[0]
PS C:\> $workspace.Name = "Test Name"
PS C:\> $workspace.Description = "Test Description"
PS C:\> Set-PowerBIWorkspace -Scope Organization -Workspace $workspace

如果当前用户是管理员，则会使用调用方组织中工作区的指定名称和说明值更新指定的工作区对象。

参数

-CapacityId

将向其分配工作区的容量对象 ID。如果 CapacityId 设置为“00000000-0000-0000-0000-00000000000000”，工作区将迁移到共享容量。

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

-Description

要提供给要更新的工作区的新说明。

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

-Id

要更新的工作区的 ID。

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

-Name

要提供给要更新的工作区的新名称。如果名称与组织中的另一个工作区匹配，则更新操作将失败。

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

-Scope

指示调用的范围。此 cmdlet 仅支持组织。组织针对租户中的所有工作区运行（必须是管理员才能启动）。个人是默认值。

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

-Workspace

要更新的工作区实体。工作区将使用对象的名称和说明进行更新。

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

输入

None

输出

System.Object

通过