Commands › Power BI

New-PowerBIReport

Power BI MicrosoftPowerBIMgmt New-*

Creates a Power BI report.

Quick start script

# New-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. Capture the current state first — you cannot roll back what you never recorded
$before = Get-PowerBIReport
$before | Format-List

# 3. Make the change
New-PowerBIReport -Path <String>

# 4. Verify and diff
$after = Get-PowerBIReport
Compare-Object ($before | Out-String) ($after | Out-String)

Syntax — 2 parameter sets

WorkspaceId (Default)

New-PowerBIReport [-Path] <String> [-Name <String>] [-WorkspaceId <Guid>]
 [-ConflictAction <ImportConflictHandlerModeEnum>] [-Timeout <Int32>] [<CommonParameters>]

Workspace

New-PowerBIReport [-Path] <String> [-Name <String>] [-Workspace <Workspace>]
 [-ConflictAction <ImportConflictHandlerModeEnum>] [-Timeout <Int32>] [<CommonParameters>]

Parameters (6)

Parameter	Type	Required	What it controls
-ConflictAction	ImportConflictHandlerModeEnum		Determines what to do if a dataset with the same name already exists. Default value is 'CreateOrOverwrite'
-Name	String		The report name. If not set, the file name will be used.
-Path	String	yes	The path to the pbix file.
-Timeout	Int32		The number of seconds to wait for the service. If not set no timeout will be used.
-Workspace	Workspace		The workspace to deploy the report to.
-WorkspaceId	Guid		The id of the workspace to deploy the report to

Reference facts derived from Microsoft documentation, © Microsoft, licensed MIT; restructured with original guidance by serv365.ai.