New-PowerBIReport

NAME New-PowerBIReport



SYNOPSIS

Creates a Power BI report.





SYNTAX

New-PowerBIReport [-Path] <String> [-ConflictAction {Ignore | Abort | Overwrite | CreateOrOverwrite}] [-Name

<String>] [-Timeout <Int32>] [-Workspace <Workspace>] [<CommonParameters>]



New-PowerBIReport [-Path] <String> [-ConflictAction {Ignore | Abort | Overwrite | CreateOrOverwrite}] [-Name

<String>] [-Timeout <Int32>] [-WorkspaceId <Guid>] [<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.





PARAMETERS

-ConflictAction <ImportConflictHandlerModeEnum>

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Name <String>

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Path <String>

The path to the pbix file.



Required? true

Position? 0

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Timeout <Int32>

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



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-Workspace <Workspace>

The workspace to deploy the report to.



Required? false

Position? named

Default value None

Accept pipeline input? False

Accept wildcard characters? false



-WorkspaceId <Guid>

The id of the workspace to deploy the report to



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

Microsoft.PowerBI.Common.Api.Reports.Report







NOTES









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



RELATED LINKS