Get-PowerBIWorkspace
Power BI ワークスペースの一覧を返します。
構文
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 パラメーターを使用して、最大 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
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
All
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Deleted
削除されたワークスペースのみを表示することを示します。 -Scope 組織が指定されている場合にのみサポートされます。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
List
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
All
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Filter
OData フィルター。大文字と小文字が区別されます (要素名は小文字で始まります)。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
List
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
All
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-First
結果の最初 (上) の一覧。 この値の既定値は 100 です。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | 100 |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ページのトップへ |
パラメーター セット
List
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Id
返されるワークスペースの ID。
パラメーターのプロパティ
| 型: | Guid
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | グループID, WorkspaceId |
パラメーター セット
Id
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Include
Power BI ワークスペースに関連付けられている関連成果物を取得します。 -Scope が組織である場合にのみ使用できます。
パラメーターのプロパティ
| 型: | ArtifactType[]
|
| 規定値: | None |
| 指定可能な値: | Reports, Dashboards, Datasets, Dataflows, Workbooks, All |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | 展開 |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
その名前を持つワークスペースが存在する場合に返すワークスペースの名前。 大文字と小文字を区別しない検索。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
Name
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Orphaned
孤立したワークスペースのみを表示することを示します。 -Scope 組織が指定されている場合にのみサポートされます。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
List
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
All
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Scope
呼び出しのスコープを示します。 個々のユーザーは、呼び出し元に割り当てられたワークスペースのみを返します。組織は、テナント内のすべてのワークスペースを返します (開始するには管理者である必要があります)。 既定値は [個人] です。
パラメーターのプロパティ
| 型: | PowerBIUserScope
|
| 規定値: | None |
| 指定可能な値: | Individual, Organization |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Skip
結果の最初のセットをスキップします。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
List
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Type
返すワークスペースの種類。 大文字と小文字を区別する検索。
パラメーターのプロパティ
| 型: | WorkspaceType
|
| 規定値: | None |
| 指定可能な値: | Workspace, Group, PersonalGroup |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
List
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Name
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
Id
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
All
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-User
ワークスペースをフィルター処理して、ユーザーが含まれているワークスペースを表示します。 -Scope が組織である場合にのみ使用できます。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
List
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
All
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
None
出力
System.Collections.Generic.IEnumerable`1