Get-PowerBIWorkspace
语法
List （默认值）
Get-PowerBIWorkspace
[-Scope <PowerBIUserScope>]
[-Filter <String>]
[-User <String>]
[-Deleted]
[-Orphaned]
[-Type <WorkspaceType>]
[-First <Int32>]
[-Skip <Int32>]
[-Include <ArtifactType[]>]
[<CommonParameters>]
Id
Get-PowerBIWorkspace
-Id <Guid>
[-Scope <PowerBIUserScope>]
[-Type <WorkspaceType>]
[-Include <ArtifactType[]>]
[<CommonParameters>]
Name
Get-PowerBIWorkspace
-Name <String>
[-Scope <PowerBIUserScope>]
[-Type <WorkspaceType>]
[-Include <ArtifactType[]>]
[<CommonParameters>]
All
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
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
All
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Deleted
指示仅显示已删除的工作区。 仅当指定 -Scope 组织时才受支持。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
List
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
All
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Filter
OData 筛选器，区分大小写（元素名称以小写开头）。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
List
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
All
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-First
第一个（top）结果列表。 此值默认值为 100。
参数属性
| 类型: | Int32
|
| 默认值: | 100 |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 顶部 |
参数集
List
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Id
要返回的工作区的 ID。
参数属性
| 类型: | Guid
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | GroupId, WorkspaceId |
参数集
Id
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Include
检索与 Power BI 工作区关联的相关项目。 仅当 -Scope 为“组织”时可用。
参数属性
| 类型: | ArtifactType[]
|
| 默认值: | None |
| 接受的值: | Reports, Dashboards, Datasets, Dataflows, Workbooks, All |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 展开 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
如果存在具有该名称的工作区的名称，则返回该工作区的名称。 不区分大小写的搜索。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
Name
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Orphaned
指示仅显示孤立工作区。 仅当指定 -Scope 组织时才受支持。
参数属性
| 类型: | SwitchParameter
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
List
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
All
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Scope
指示调用的范围。 个人仅返回分配给调用方的工作区;组织返回租户中的所有工作区（必须是要启动的管理员）。 个人是默认值。
参数属性
| 类型: | PowerBIUserScope
|
| 默认值: | None |
| 接受的值: | Individual, Organization |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Skip
跳过第一组结果。
参数属性
| 类型: | Int32
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
List
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Type
要返回的工作区的类型。 区分大小写的搜索。
参数属性
| 类型: | WorkspaceType
|
| 默认值: | None |
| 接受的值: | Workspace, Group, PersonalGroup |
| 支持通配符: | False |
| 不显示: | False |
参数集
List
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
Name
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
Id
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
All
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-User
筛选工作区以显示用户所在的工作区。 仅当 -Scope 为“组织”时可用。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
List
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
All
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
None
输出
System.Collections.Generic.IEnumerable`1