Commands › Power BI
Get-PowerBIReport
Returns a list of Power BI reports.
Quick start script
# Get-PowerBIReport — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-PowerBIServiceAccount -ServicePrincipal -CertificateThumbprint $thumb -ApplicationId $appId -Tenant $tenantId
# 2. Run and inspect
Get-PowerBIReport -Id <Guid> -Name <String> -Workspace <Workspace> | Format-List
# 3. Export for evidence / drift tracking
Get-PowerBIReport | Export-Clixml .\PowerBIReport-$(Get-Date -Format yyyyMMdd).xmlSyntax — 6 parameter sets
List (Default)
Get-PowerBIReport [-Scope <PowerBIUserScope>] [-Filter <String>] [-First <Int32>] [-Skip <Int32>]
[-WorkspaceId <Guid>] [<CommonParameters>]Id
Get-PowerBIReport -Id <Guid> [-Scope <PowerBIUserScope>] [-WorkspaceId <Guid>] [<CommonParameters>]ObjectAndId
Get-PowerBIReport -Id <Guid> [-Scope <PowerBIUserScope>] -Workspace <Workspace> [<CommonParameters>]Name
Get-PowerBIReport -Name <String> [-Scope <PowerBIUserScope>] [-WorkspaceId <Guid>] [<CommonParameters>]2 more parameter sets — see the parameter table below.
Parameters (8)
| Parameter | Type | Required | What it controls |
|---|---|---|---|
| -Filter | String | OData filter, case-sensitive (element names start lowercase). Only supported when -Scope Organization is specified. | |
| -First | Int32 | First (top) list of results. | |
| -Id | Guid | yes | ID of the report to return. |
| -Name | String | yes | Name of the report to return if one exists with that name. Case insensitive search. |
| -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. | |
| -Skip | Int32 | Skips the first set of results. | |
| -Workspace | Workspace | yes | Workspace to filter results to; only reports that belong to that workspace are shown. |
| -WorkspaceId | Guid | ID of the workspace to filter results to; only reports that belong to that workspace are shown. |
Reference facts derived from Microsoft documentation, © Microsoft, licensed MIT; restructured with original guidance by serv365.ai.