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>] Description
擷取符合指定搜尋準則和範圍的Power BI工作區清單。 根據預設，它會顯示指派給使用者的前 100 個工作區（不含 -First 參數）。 使用 -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
要傳回之工作區的標識碼。
| 類型: | 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]]