< Back
Copy-PowerBITile
Post
NAME Copy-PowerBITile
SYNOPSIS
Creates a copy of the specified Power BI tile and adds it to a Power BI dashboard.
SYNTAX
Copy-PowerBITile -DashboardId <String> [-PositionConflictAction <String>] -TargetDashboardId <String>
[-TargetDatasetId <String>] [-TargetReportId <String>] [-TargetWorkspaceId <String>] -TileId <String> -Workspace
<Workspace> [<CommonParameters>]
Copy-PowerBITile -DashboardId <String> [-PositionConflictAction <String>] -TargetDashboardId <String>
[-TargetDatasetId <String>] [-TargetReportId <String>] [-TargetWorkspaceId <String>] -TileId <String> -WorkspaceId
<Guid> [<CommonParameters>]
DESCRIPTION
Creates a copy of the specified tile and adds it to a dashboard. If target report ID and target dataset ID are not
specified, the following can occur: * When a tile copy is created within the same workspace, the report and
dataset links will be copied from the source tile.
* When copying a tile to a different workspace, the report and dataset links will be rested, and the tile will be
broken.
PARAMETERS
-DashboardId <String>
The ID of the dashboard where source tile is located.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PositionConflictAction <String>
Optional parameter for specifying the action in case of position conflict. The default is 'Tail'.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TargetDashboardId <String>
The ID of the dashboard where tile copy should be added.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TargetDatasetId <String>
Optional parameter to rebind the copied tile to a different dataset.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TargetReportId <String>
Optional parameter to rebind the copied tile to a different report.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TargetWorkspaceId <String>
Optional parameter for specifying the target workspace ID. Empty Guid (00000000-0000-0000-0000-000000000000)
indicates 'My Workspace'. Empty string indicates tile will be copied within the same workspace.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TileId <String>
The ID of the tile that should be copied
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Workspace <Workspace>
Workspace object, as returned by the Get-PowerBIWorkspace cmdlet, where the source dashboard is located.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-WorkspaceId <Guid>
The ID of the workspace where the source dashboard is located. Empty Guid
(00000000-0000-0000-0000-000000000000) indicates 'My Workspace'.
Required? true
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
Microsoft.PowerBI.Common.Api.Reports.Dashboard
NOTES
-------------------------- Example 1 --------------------------
PS C:\\> Copy-PowerBITile -DashboardId cff24b2e-faa8-4683-8ecb-2c50e7d2cc7a -TileId
e297e105-be30-4482-8531-152cdf289ac6 -TargetDashboardId 8f88d7ab-49e7-41e0-979b-28f063056daa -targetWorkspaceId
166bc04e-da57-426b-b7b4-d24d0e3e5587 -TargetReportId 1fb4359e-9356-4193-9965-a9472a0051b8 -TargetDatasetId
a96cd411-4562-4eba-ba2a-42fee8425a87
Creates a copy of the tile with the ID "e297e105-be30-4482-8531-152cdf289ac6" from a dashboard with ID
"cff24b2e-faa8-4683-8ecb-2c50e7d2cc7a" and adds it to the dashboard with ID "8f88d7ab-49e7-41e0-979b-28f063056daa"
in the workspace with ID "166bc04e-da57-426b-b7b4-d24d0e3e5587" and links it to the report with the ID
"1fb4359e-9356-4193-9965-a9472a0051b8" and the dataset with ID "a96cd411-4562-4eba-ba2a-42fee8425a87" in the
target workspace.
RELATED LINKS
SYNOPSIS
Creates a copy of the specified Power BI tile and adds it to a Power BI dashboard.
SYNTAX
Copy-PowerBITile -DashboardId <String> [-PositionConflictAction <String>] -TargetDashboardId <String>
[-TargetDatasetId <String>] [-TargetReportId <String>] [-TargetWorkspaceId <String>] -TileId <String> -Workspace
<Workspace> [<CommonParameters>]
Copy-PowerBITile -DashboardId <String> [-PositionConflictAction <String>] -TargetDashboardId <String>
[-TargetDatasetId <String>] [-TargetReportId <String>] [-TargetWorkspaceId <String>] -TileId <String> -WorkspaceId
<Guid> [<CommonParameters>]
DESCRIPTION
Creates a copy of the specified tile and adds it to a dashboard. If target report ID and target dataset ID are not
specified, the following can occur: * When a tile copy is created within the same workspace, the report and
dataset links will be copied from the source tile.
* When copying a tile to a different workspace, the report and dataset links will be rested, and the tile will be
broken.
PARAMETERS
-DashboardId <String>
The ID of the dashboard where source tile is located.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-PositionConflictAction <String>
Optional parameter for specifying the action in case of position conflict. The default is 'Tail'.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TargetDashboardId <String>
The ID of the dashboard where tile copy should be added.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TargetDatasetId <String>
Optional parameter to rebind the copied tile to a different dataset.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TargetReportId <String>
Optional parameter to rebind the copied tile to a different report.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TargetWorkspaceId <String>
Optional parameter for specifying the target workspace ID. Empty Guid (00000000-0000-0000-0000-000000000000)
indicates 'My Workspace'. Empty string indicates tile will be copied within the same workspace.
Required? false
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-TileId <String>
The ID of the tile that should be copied
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-Workspace <Workspace>
Workspace object, as returned by the Get-PowerBIWorkspace cmdlet, where the source dashboard is located.
Required? true
Position? named
Default value None
Accept pipeline input? False
Accept wildcard characters? false
-WorkspaceId <Guid>
The ID of the workspace where the source dashboard is located. Empty Guid
(00000000-0000-0000-0000-000000000000) indicates 'My Workspace'.
Required? true
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
Microsoft.PowerBI.Common.Api.Reports.Dashboard
NOTES
-------------------------- Example 1 --------------------------
PS C:\\> Copy-PowerBITile -DashboardId cff24b2e-faa8-4683-8ecb-2c50e7d2cc7a -TileId
e297e105-be30-4482-8531-152cdf289ac6 -TargetDashboardId 8f88d7ab-49e7-41e0-979b-28f063056daa -targetWorkspaceId
166bc04e-da57-426b-b7b4-d24d0e3e5587 -TargetReportId 1fb4359e-9356-4193-9965-a9472a0051b8 -TargetDatasetId
a96cd411-4562-4eba-ba2a-42fee8425a87
Creates a copy of the tile with the ID "e297e105-be30-4482-8531-152cdf289ac6" from a dashboard with ID
"cff24b2e-faa8-4683-8ecb-2c50e7d2cc7a" and adds it to the dashboard with ID "8f88d7ab-49e7-41e0-979b-28f063056daa"
in the workspace with ID "166bc04e-da57-426b-b7b4-d24d0e3e5587" and links it to the report with the ID
"1fb4359e-9356-4193-9965-a9472a0051b8" and the dataset with ID "a96cd411-4562-4eba-ba2a-42fee8425a87" in the
target workspace.
RELATED LINKS