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 Organization，并且必须具有管理员权限 (，例如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"

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

示例 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-000000000000000”，则工作区将迁移到共享容量。

Type:	Guid
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

要更新的工作区的新说明。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Id

要更新的工作区的 ID。

Type:	Guid
Aliases:	GroupId, WorkspaceId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Scope

指示调用的范围。此 cmdlet 仅支持组织。组织对租户 (内的所有工作区进行操作必须是管理员才能启动) 。单个是默认值。

Type:	PowerBIUserScope
Accepted values:	Individual, Organization
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Workspace

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

Type:	Workspace
Aliases:	Group
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

输入

None

输出

System.Object

通过