Copy-PowerBITile

Module:

MicrosoftPowerBIMgmt.Reports Module

Creates a copy of the specified Power BI tile and adds it to a Power BI dashboard.

Syntax

MyWorkspace (Default)

Copy-PowerBITile
    -DashboardId <String>
    -TileId <String>
    -TargetDashboardId <String>
    [-TargetWorkspaceId <String>]
    [-TargetReportId <String>]
    [-TargetDatasetId <String>]
    [-PositionConflictAction <String>]
    [<CommonParameters>]

WorkspaceId

Copy-PowerBITile
    -WorkspaceId <Guid>
    -DashboardId <String>
    -TileId <String>
    -TargetDashboardId <String>
    [-TargetWorkspaceId <String>]
    [-TargetReportId <String>]
    [-TargetDatasetId <String>]
    [-PositionConflictAction <String>]
    [<CommonParameters>]

WorkspaceObject

Copy-PowerBITile
    -Workspace <Workspace>
    -DashboardId <String>
    -TileId <String>
    -TargetDashboardId <String>
    [-TargetWorkspaceId <String>]
    [-TargetReportId <String>]
    [-TargetDatasetId <String>]
    [-PositionConflictAction <String>]
    [<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.

Examples

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.

Parameters

-DashboardId

The ID of the dashboard where source tile is located.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	DashboardKey

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-PositionConflictAction

Optional parameter for specifying the action in case of position conflict. The default is 'Tail'.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-TargetDashboardId

The ID of the dashboard where tile copy should be added.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-TargetDatasetId

Optional parameter to rebind the copied tile to a different dataset.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	TargetModelId

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-TargetReportId

Optional parameter to rebind the copied tile to a different report.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-TargetWorkspaceId

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.

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	TargetGroupId

Parameter sets

(All)

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-TileId

The ID of the tile that should be copied

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	TileKey

Parameter sets

(All)

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Workspace

Workspace object, as returned by the Get-PowerBIWorkspace cmdlet, where the source dashboard is located.

Parameter properties

Type:	Workspace
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	Group

Parameter sets

WorkspaceObject

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-WorkspaceId

The ID of the workspace where the source dashboard is located. Empty Guid (00000000-0000-0000-0000-000000000000) indicates 'My Workspace'.

Parameter properties

Type:	Guid
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	GroupId

Parameter sets

WorkspaceId

Position:	Named
Mandatory:	True
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Inputs

None

Outputs

Microsoft.PowerBI.Common.Api.Reports.Dashboard