Get-PowerBIWorkspace

模块:

MicrosoftPowerBIMgmt.Workspaces

返回 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 工作区。

示例 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 不能与此参数一起使用。

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

-Deleted

指示仅显示已删除的工作区。 仅在指定 -Scope 组织时受支持。

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

-Filter

OData 筛选器，区分大小写的 (元素名称从小写) 开始。

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

-First

第一个 (结果) 列表。 此值默认值为 100。

Type:	Int32
Aliases:	Top
Position:	Named
Default value:	100
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:	False
Accept wildcard characters:	False

-Include

检索与 Power BI 工作区关联的相关项目。 仅当 -Scope 为组织时才可用。

Type:	ArtifactType[]
Aliases:	Expand
Accepted values:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

如果存在具有该名称的工作区的名称，则返回该工作区的名称。 不区分大小写的搜索。

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

-Orphaned

指示仅显示孤立工作区。 仅在指定 -Scope 组织时受支持。

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

-Scope

指示调用的范围。 个人仅返回分配给调用方的工作区;组织返回租户中的所有工作区 (必须是管理员才能启动) 。 个人是默认值。

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

-Skip

跳过第一组结果。

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

-Type

要返回的工作区的类型。 区分大小写的搜索。

Type:	WorkspaceType
Accepted values:	Workspace, Group, PersonalGroup
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-User

筛选工作区以显示用户包含在其中的工作区。 仅当 -Scope 为组织时才可用。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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]]