Commands › Power BI

Copy-PowerBIReport

Power BI MicrosoftPowerBIMgmt Copy-*

Creates a copy of the specified Power BI report.

Quick start script

# Copy-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
Copy-PowerBIReport -Id <Guid> -Name <String> -Report <Report> | Format-List

# 3. Export for evidence / drift tracking
Copy-PowerBIReport | Export-Clixml .\PowerBIReport-$(Get-Date -Format yyyyMMdd).xml

Syntax — 2 parameter sets

Id (Default)

Copy-PowerBIReport -Name <String> -Id <Guid> [-WorkspaceId <String>] [-Workspace <Workspace>]
 [-TargetWorkspaceId <String>] [-TargetDatasetId <String>] [<CommonParameters>]

WorkspaceObject

Copy-PowerBIReport [-Name <String>] -Report <Report> [-WorkspaceId <String>] [-Workspace <Workspace>]
 [-TargetWorkspaceId <String>] [-TargetDatasetId <String>] [<CommonParameters>]

Parameters (7)

Parameter	Type	Required	What it controls
-Id	Guid	yes	The ID of the original report to copy.
-Name	String	yes	The new report name that will be assigned to the copied report.
-Report	Report	yes	The original report object, as obtained by using the Get-PowerBIReport cmdlet.
-TargetDatasetId	String		Optional parameter for specifying the target associated dataset ID. If empty, the new report will be associated with the same dataset as the source report.
-TargetWorkspaceId	String		The ID of the target workspace. Empty Guid (00000000-0000-0000-0000-000000000000) indicates 'My Workspace'. Empty string indicates new report will be copied within the same workspace as the source report.
-Workspace	Workspace		The workspace object, as obtained by using the Get-PowerBIWorkspace cmdlets, where the original report is located. If empty, source workspace is 'My Workspace'.
-WorkspaceId	String		The ID of the workspace where the original report is located. If empty, source workspace is 'My Workspace'.

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