Get-PowerBIWorkspace
返回 Power BI 工作区的列表。
语法
Get-PowerBIWorkspace
[-Scope <PowerBIUserScope>]
[-Filter <String>]
[-User <String>]
[-Deleted]
[-Orphaned]
[-Type <WorkspaceType>]
[-First <Int32>]
[-Skip <Int32>]
[-Include <ArtifactType[]>]
[<CommonParameters>] Get-PowerBIWorkspace
-Id <Guid>
[-Scope <PowerBIUserScope>]
[-Type <WorkspaceType>]
[-Include <ArtifactType[]>]
[<CommonParameters>] Get-PowerBIWorkspace
-Name <String>
[-Scope <PowerBIUserScope>]
[-Type <WorkspaceType>]
[-Include <ArtifactType[]>]
[<CommonParameters>] Get-PowerBIWorkspace
[-Scope <PowerBIUserScope>]
[-Filter <String>]
[-User <String>]
[-Deleted]
[-Orphaned]
[-Type <WorkspaceType>]
[-Include <ArtifactType[]>]
[-All]
[<CommonParameters>] 说明
检索与指定搜索条件和范围匹配的 Power BI 工作区的列表。 默认情况下（不带 -First 参数），它显示分配给用户的前 100 个工作区。 使用 -First 和 -Skip 提取更多工作区或使用 -All 返回所有工作区。 -First 参数可用于返回最多 5000 个工作区。 运行此命令之前，请确保使用 Connect-PowerBIServiceAccount 登录。
示例
示例 1
PS C:\> Get-PowerBIWorkspace返回呼叫用户分配到的前 100 个 Power BI 工作区（-Scope 个人）。
示例 2
PS C:\> Get-PowerBIWorkspace -All返回呼叫用户分配到的所有 Power BI 工作区。
示例 3
PS C:\> Get-PowerBIWorkspace -Scope Organization -Filter "tolower(name) eq 'contoso sales'"返回用户组织中名为“Contoso Sales”的工作区（不区分 tolower 大小写）。
示例 3
PS C:\> Get-PowerBIWorkspace -Scope Organization -Include All返回所有 Power BI 工作区以及用户组织中的相关报表、仪表板、数据集、数据流和工作簿。
参数
-All
指示显示所有工作区。 -First 和 -Skip 不能与此参数一起使用。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Deleted
指示仅显示已删除的工作区。 仅当指定 -Scope 组织时才受支持。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Filter
OData 筛选器，区分大小写（元素名称以小写开头）。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-First
第一个（top）结果列表。 此值默认值为 100。
| 类型: | Int32 |
| 别名: | Top |
| Position: | Named |
| 默认值: | 100 |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Id
要返回的工作区的 ID。
| 类型: | Guid |
| 别名: | GroupId, WorkspaceId |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Include
检索与 Power BI 工作区关联的相关项目。 仅当 -Scope 为“组织”时可用。
| 类型: | ArtifactType[] |
| 别名: | Expand |
| 接受的值: | Reports, Dashboards, Datasets, Dataflows, Workbooks, All |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
如果存在具有该名称的工作区的名称，则返回该工作区的名称。 不区分大小写的搜索。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | True |
| 接受管道输入: | False |
| 接受通配符: | False |
-Orphaned
指示仅显示孤立工作区。 仅当指定 -Scope 组织时才受支持。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Scope
指示调用的范围。 个人仅返回分配给调用方的工作区;组织返回租户中的所有工作区（必须是要启动的管理员）。 个人是默认值。
| 类型: | PowerBIUserScope |
| 接受的值: | Individual, Organization |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Skip
跳过第一组结果。
| 类型: | Int32 |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Type
要返回的工作区的类型。 区分大小写的搜索。
| 类型: | WorkspaceType |
| 接受的值: | Workspace, Group, PersonalGroup |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-User
筛选工作区以显示用户所在的工作区。 仅当 -Scope 为“组织”时可用。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
输入
None
输出
System.Collections.Generic.IEnumerable`1[[Microsoft.PowerBI.Common.Api.Workspaces.Workspace, Microsoft.PowerBI.Common.Api, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]