Edit

Share via

Copy-PowerBIReport

  • Reference
Module:
MicrosoftPowerBIMgmt.Reports

Creates a copy of the specified Power BI report.

Syntax

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

Description

Creates a copy of the specified Power BI report in the same Power BI workspace or in a different workspace and rebinds the report to a referenced dataset in the target workspace.

Examples

Example 1

PowerShell 
PS C:\> Copy-PowerBIReport -Name "Report Copy" -Id "30ca8f24-f628-45f7-a5ac-540c95e9b5e6" -WorkspaceId "00000000-0000-0000-0000-000000000000" -TargetWorkspaceId "6439d4d4-18c4-4762-b755-1f957d55383e" -TargetDatasetId "74f6adb5-93eb-49d8-918c-6df248cb73dd"

Creates a copy of the report with ID "30ca8f24-f628-45f7-a5ac-540c95e9b5e6" from 'My Workspace' in the target workspace with ID "6439d4d4-18c4-4762-b755-1f957d55383e", assigns the report copy the name "Report Copy", and binds it to the dataset with the ID "74f6adb5-93eb-49d8-918c-6df248cb73dd".

Example 2

PowerShell 
PS C:\> Copy-PowerBIReport -Name "Report Copy" -Id "bd200f64-46f1-4f82-b09f-c7fd6818d67c" -WorkspaceId "6439d4d4-18c4-4762-b755-1f957d55383e" -TargetWorkspaceId "00000000-0000-0000-0000-000000000000" -TargetDatasetId "1b46e4dc-1299-425b-97aa-c10d51f82a06"

Creates a copy of the report with ID "bd200f64-46f1-4f82-b09f-c7fd6818d67c"" from the workspace with the ID "6439d4d4-18c4-4762-b755-1f957d55383e" in 'My Workspace' as the target workspace, assigns the report copy the name "Report Copy", and binds it to the dataset with the ID "1b46e4dc-1299-425b-97aa-c10d51f82a06".

Example 3

PowerShell 
PS C:\> Copy-PowerBIReport -Name "Report Copy" -Id "30ca8f24-f628-45f7-a5ac-540c95e9b5e6"

Creates a copy of the report with ID "30ca8f24-f628-45f7-a5ac-540c95e9b5e6" in the same workspace, assigns the report copy the name "Report Copy", and binds it to the dataset that the original report is associated with.

Parameters

-Id

The ID of the original report to copy.

Type:Guid
Aliases:ReportId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

The new report name that will be assigned to the copied report.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Report

The original report object, as obtained by using the Get-PowerBIReport cmdlet.

Type:Report
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-TargetDatasetId

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.

Type:String
Aliases:TargetModelId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TargetWorkspaceId

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.

Type:String
Aliases:TargetGroupId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-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'.

Type:Workspace
Aliases:Group
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WorkspaceId

The ID of the workspace where the original report is located. If empty, source workspace is 'My Workspace'.

Type:String
Aliases:GroupId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.Object