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, которым назначается вызывающий пользователь (-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
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Deleted

Указывает на отображение только удаленных рабочих областей. Поддерживается только при указании -Scope организации.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Filter

Фильтр OData, учитывает регистр (имена элементов начинаются в нижнем регистре).

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-First

Первый (верхний) список результатов. Это значение по умолчанию равно 100.

Тип:Int32
Aliases:Top
Position:Named
Default value:100
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Id

Идентификатор возвращаемой рабочей области.

Тип:Guid
Aliases:GroupId, WorkspaceId
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Include

Извлекает связанные артефакты, связанные с рабочей областью Power BI. Доступно только в том случае, если -Scope является организацией.

Тип:ArtifactType[]
Aliases:Expand
Допустимые значения:Reports, Dashboards, Datasets, Dataflows, Workbooks, All
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Name

Имя рабочей области, возвращаемой, если она существует с этим именем. Поиск без учета регистра.

Тип:String
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Orphaned

Указывает на отображение только потерянных рабочих областей. Поддерживается только при указании -Scope организации.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Scope

Указывает область вызова. Отдельные возвращают только рабочие области, назначенные вызывающему объекту; Организация возвращает все рабочие области в клиенте (должен быть администратором для инициирования). Индивидуальный — это значение по умолчанию.

Тип:PowerBIUserScope
Допустимые значения:Individual, Organization
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Skip

Пропускает первый набор результатов.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Type

Тип возвращаемой рабочей области. Поиск с учетом регистра.

Тип:WorkspaceType
Допустимые значения:Workspace, Group, PersonalGroup
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-User

Отфильтруйте рабочие области, чтобы отобразить те, в которых находится пользователь. Доступно только в том случае, если -Scope является организацией.

Тип:String
Position:Named
Default value: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]]