Get-PowerBIWorkspace

模組:

MicrosoftPowerBIMgmt.Workspaces

傳回 Power BI 工作區的清單。

Syntax

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>]

Description

擷取符合指定搜尋準則和範圍的 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' 的工作區， (與使用者組織內的) 不區分大小寫。

範例 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 Organization 時才支援。

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

要傳回之工作區的識別碼。

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 Organization 時才支援。

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]]