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 パラメーターを使用して、最大 5,000 個のワークスペースを返すことができます。このコマンドを実行する前に、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
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Deleted

削除されたワークスペースのみを表示することを示します。 -Scope 組織が指定されている場合にのみサポートされます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Filter

OData フィルター。大文字と小文字が区別されます (要素名は小文字で始まります)。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-First

結果の最初 (上) の一覧。この値の既定値は 100 です。

型:	Int32
Aliases:	Top
配置:	Named
規定値:	100
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Id

返されるワークスペースの ID。

型:	Guid
Aliases:	GroupId, WorkspaceId
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Include

Power BI ワークスペースに関連付けられている関連成果物を取得します。 -Scope が組織である場合にのみ使用できます。

型:	ArtifactType[]
Aliases:	Expand
指定可能な値:	Reports, Dashboards, Datasets, Dataflows, Workbooks, All
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Name

その名前を持つワークスペースが存在する場合に返すワークスペースの名前。大文字と小文字を区別しない検索。

型:	String
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Orphaned

孤立したワークスペースのみを表示することを示します。 -Scope 組織が指定されている場合にのみサポートされます。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Scope

呼び出しのスコープを示します。個々のユーザーは、呼び出し元に割り当てられたワークスペースのみを返します。組織は、テナント内のすべてのワークスペースを返します (開始するには管理者である必要があります)。既定値は [個人] です。

型:	PowerBIUserScope
指定可能な値:	Individual, Organization
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Skip

結果の最初のセットをスキップします。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Type

返すワークスペースの種類。大文字と小文字を区別する検索。

型:	WorkspaceType
指定可能な値:	Workspace, Group, PersonalGroup
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-User

ワークスペースをフィルター処理して、ユーザーが含まれているワークスペースを表示します。 -Scope が組織である場合にのみ使用できます。

型:	String
配置:	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]]

次の方法で共有