Compartilhar via


Get-PowerBIReport

Retorna uma lista de relatórios do Power BI.

Sintaxe

Get-PowerBIReport
   [-Scope <PowerBIUserScope>]
   [-Filter <String>]
   [-First <Int32>]
   [-Skip <Int32>]
   [-WorkspaceId <Guid>]
   [<CommonParameters>]
Get-PowerBIReport
   -Id <Guid>
   [-Scope <PowerBIUserScope>]
   [-WorkspaceId <Guid>]
   [<CommonParameters>]
Get-PowerBIReport
   -Id <Guid>
   [-Scope <PowerBIUserScope>]
   -Workspace <Workspace>
   [<CommonParameters>]
Get-PowerBIReport
   -Name <String>
   [-Scope <PowerBIUserScope>]
   [-WorkspaceId <Guid>]
   [<CommonParameters>]
Get-PowerBIReport
   -Name <String>
   [-Scope <PowerBIUserScope>]
   -Workspace <Workspace>
   [<CommonParameters>]
Get-PowerBIReport
   [-Scope <PowerBIUserScope>]
   [-Filter <String>]
   [-First <Int32>]
   [-Skip <Int32>]
   -Workspace <Workspace>
   [<CommonParameters>]

Description

Recupera uma lista de relatórios do Power BI que correspondem aos critérios de pesquisa e ao escopo especificados. Antes de executar esse comando, faça logon usando Connect-PowerBIServiceAccount.

Exemplos

Exemplo 1

PS C:\> Get-PowerBIReport

Retorna uma lista de todos os relatórios do PowerBI aos quais um usuário tem acesso.

Exemplo 2

PS C:\> Get-PowerBIReport -Scope Organization

Retorna uma lista de todos os relatórios do PowerBI dentro da organização de um usuário.

Parâmetros

-Filter

Filtro OData, diferencia maiúsculas de minúsculas (os nomes dos elementos iniciam em letras minúsculas). Só há suporte quando -Scope Organização é especificada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-First

Primeira lista (superior) de resultados.

Tipo:Int32
Aliases:Top
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

ID do relatório a ser retornado.

Tipo:Guid
Aliases:ReportId
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Nome do relatório a ser retornado se houver um com esse nome. Pesquisa sem diferenciação de maiúsculas de minúsculas.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Scope

Indica o escopo da chamada. O indivíduo retorna apenas os relatórios atribuídos ao chamador; A organização retorna todos os relatórios dentro de um locatário (deve ser um administrador a ser iniciado). Individual é o padrão.

Tipo:PowerBIUserScope
Valores aceitos:Individual, Organization
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Skip

Ignora o primeiro conjunto de resultados.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Workspace

Workspace para o qual filtrar os resultados; somente os relatórios que pertencem a esse workspace são mostrados.

Tipo:Workspace
Aliases:Group
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WorkspaceId

ID do workspace para o qual filtrar os resultados; somente os relatórios que pertencem a esse workspace são mostrados.

Tipo:Guid
Aliases:GroupId
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

System.Collections.Generic.IEnumerable`1[[Microsoft.PowerBI.Common.Api.Reports.Report, Microsoft.PowerBI.Common.Api, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]