Edit

Share via

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