Edit

Share via

New-PowerBIReport

Module:
MicrosoftPowerBIMgmt.Reports Module

Creates a Power BI report.

Syntax

WorkspaceId (Default) 

New-PowerBIReport
    [-Path] <String>
    [-Name <String>]
    [-WorkspaceId <Guid>]
    [-ConflictAction <ImportConflictHandlerModeEnum>]
    [-Timeout <Int32>]
    [<CommonParameters>]

Workspace 

New-PowerBIReport
    [-Path] <String>
    [-Name <String>]
    [-Workspace <Workspace>]
    [-ConflictAction <ImportConflictHandlerModeEnum>]
    [-Timeout <Int32>]
    [<CommonParameters>]

Description

Loads a Power BI report from a pbix file and deploys it to the Power BI service. Before you run this command, make sure you log in using Connect-PowerBIServiceAccount.

Examples

Example 1

PS C:\> New-PowerBIReport -Path '.\report.pbix' -Name 'Report'

Adds the report to the personal Workspace.

Example 2

PS C:\> New-PowerBIReport -Path '.\report.pbix' -Name 'Report' -Workspace ( Get-PowerBIWorkspace -Name 'Team Workspace' )

Adds the report to the Team Workspace.

Parameters

-ConflictAction

Determines what to do if a dataset with the same name already exists. Default value is 'CreateOrOverwrite'

Parameter properties

Type:ImportConflictHandlerModeEnum
Default value:None
Accepted values:Ignore, Abort, Overwrite, CreateOrOverwrite
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

-Name

The report name. If not set, the file name will be used.

Parameter properties

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

Parameter sets

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

-Path

The path to the pbix file.

Parameter properties

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

Parameter sets

(All)
Position:0
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Timeout

The number of seconds to wait for the service. If not set no timeout will be used.

Parameter properties

Type:Int32
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

-Workspace

The workspace to deploy the report to.

Parameter properties

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

Parameter sets

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

-WorkspaceId

The id of the workspace to deploy the report to

Parameter properties

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

Parameter sets

WorkspaceId
Position:Named
Mandatory:False
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.Report