Edit

Share via


New-PowerBIDashboard

Creates a new empty Power BI dashboard.

Syntax

NameOnly (Default)

New-PowerBIDashboard
    -Name <String>
    [<CommonParameters>]

NameAndIds

New-PowerBIDashboard
    -Name <String>
    -WorkspaceId <Guid>
    [<CommonParameters>]

NameAndObject

New-PowerBIDashboard
    -Name <String>
    -Workspace <Workspace>
    [<CommonParameters>]

Description

Creates a new empty dashboard in "My Workspace" or in a specified workspace.

Examples

Example 1

PS C:\> New-PowerBIDashboard -Name "New Dashboard"

Creates a new dashboard called "New Dashboard" in "My Workspace".

Example 2

PS C:\> New-PowerBIDashboard -Name "New Dashboard" -WorkspaceId 084d15de-4c96-4a66-97b4-c60914a0973c

Creates a new dashboard called "New Dashboard" in an existing workspace with ID "084d15de-4c96-4a66-97b4-c60914a0973c".

Parameters

-Name

Name of the dashboard.

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

-Workspace

Workspace object, as returned by the Get-PowerBIWorkspace cmdlet, in which the dashboard should be created.

Parameter properties

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

Parameter sets

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

-WorkspaceId

ID of the workspace in which the dashboard should be created.

Parameter properties

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

Parameter sets

NameAndIds
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