Set-PowerBIWorkspace
语法
Properties （默认值）
Set-PowerBIWorkspace
-Id <Guid>
[-Scope <PowerBIUserScope>]
[-Name <String>]
[-Description <String>]
[<CommonParameters>]
Workspace
Set-PowerBIWorkspace
-Workspace <Workspace>
[-Scope <PowerBIUserScope>]
[<CommonParameters>]
Capacity
Set-PowerBIWorkspace
-Id <Guid>
-CapacityId <Guid>
[-Scope <PowerBIUserScope>]
[<CommonParameters>]
说明
更新 Power BI 工作区的名称或说明。
仅支持新工作区体验预览中的工作区。
仅支持 -Scope 组织，您必须具有适当的权限或角色（例如 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
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Capacity
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Description
要提供给要更新的工作区的新说明。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Properties
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Id
要更新的工作区的 ID。
参数属性
| 类型: | Guid
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | GroupId, WorkspaceId |
参数集
Properties
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
Capacity
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Name
要提供给要更新的工作区的新名称。 如果名称与组织中的另一个工作区匹配，则更新操作将失败。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Properties
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Scope
指示调用的范围。 此 cmdlet 仅支持组织。
组织针对租户中的所有工作区运行（必须是管理员才能启动）。 个人是默认值。
参数属性
| 类型: | 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。
None
输出
System.Object