< Back

Copy-PowerBIReport

Sat Jan 18, 2020 4:14 pm

NAME Copy-PowerBIReport



SYNOPSIS

Creates a copy of the specified Power BI report.





SYNTAX

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

<Workspace>] [-WorkspaceId <String>] [<CommonParameters>]



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

[-Workspace <Workspace>] [-WorkspaceId <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.





PARAMETERS

-Id <Guid>

The ID of the original report to copy.



Required? true

Position? named

Default value None

Accept pipeline input? True (ByPropertyName)

Accept wildcard characters? false



-Name <String>

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



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Report <Report>

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



Required? true

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-WorkspaceId <String>

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



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







NOTES









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



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



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 1 --------------------------



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.



RELATED LINKS