Поделиться через

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 Individual).

Пример 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 нельзя использовать с этим параметром.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Deleted

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

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.

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