Get-PowerBIReport

NAME Get-PowerBIReport



SYNOPSIS

Returns a list of Power BI reports.





SYNTAX

Get-PowerBIReport [-Filter <String>] [-First <Int32>] [-Scope {Individual | Organization}] [-Skip <Int32>]

[-WorkspaceId <Guid>] [<CommonParameters>]



Get-PowerBIReport [-Filter <String>] [-First <Int32>] [-Scope {Individual | Organization}] [-Skip <Int32>]

-Workspace <Workspace> [<CommonParameters>]



Get-PowerBIReport -Id <Guid> [-Scope {Individual | Organization}] [-WorkspaceId <Guid>] [<CommonParameters>]



Get-PowerBIReport -Id <Guid> [-Scope {Individual | Organization}] -Workspace <Workspace> [<CommonParameters>]



Get-PowerBIReport -Name <String> [-Scope {Individual | Organization}] [-WorkspaceId <Guid>] [<CommonParameters>]



Get-PowerBIReport -Name <String> [-Scope {Individual | Organization}] -Workspace <Workspace> [<CommonParameters>]





DESCRIPTION

Retrieves a list of Power BI reports that match the specified search criteria and scope. Before you run this

command, make sure you log in using Connect-PowerBIServiceAccount.





PARAMETERS

-Filter <String>

OData filter, case-sensitive (element names start lowercase). Only supported when -Scope Organization is

specified.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-First <Int32>

First (top) list of results.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Id <Guid>

ID of the report to return.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

Name of the report to return if one exists with that name. Case insensitive search.



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Scope <PowerBIUserScope>

Indicates scope of the call. Individual returns only reports assigned to the caller; Organization returns all

reports within a tenant (must be an administrator to initiate). Individual is the default.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Skip <Int32>

Skips the first set of results.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Workspace <Workspace>

Workspace to filter results to; only reports that belong to that workspace are shown.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByValue)

Accept wildcard characters? false



-WorkspaceId <Guid>

ID of the workspace to filter results to; only reports that belong to that workspace are shown.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS

None







OUTPUTS

System.Collections.Generic.IEnumerable`1[[Microsoft.PowerBI.Common.Api.Reports.Report,

Microsoft.PowerBI.Common.Api, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]







NOTES









-------------------------- Example 1 --------------------------



PS C:\\> Get-PowerBIReport



Returns a list of all PowerBI reports that a user has access to.

-------------------------- Example 2 --------------------------



PS C:\\> Get-PowerBIReport -Scope Organization



Returns a list of all PowerBI reports within a user's organization.



RELATED LINKS

Online Version:

https://docs.microsoft.com/en-us/powers ... powerbi-ps