New-PowerBIDataset

Creates a new Power BI dataset object.

Syntax

New-PowerBIDataset
   -Name <String>
   [-Tables <Table[]>]
   [<CommonParameters>]

Description

Initiates the creation of a Power BI dataset object. A Power BI dataset is a container for tables.

Examples

Example 1

PS C:\>$col1 = New-PowerBIColumn -Name ID -DataType Int64
PS C:\>$col2 = New-PowerBIColumn -Name Data -DataType String
PS C:\>$table1 = New-PowerBITable -Name SampleTable1 -Columns $col1,$col2
PS C:\>
PS C:\>$col3 = New-PowerBIColumn -Name ID -DataType Int64
PS C:\>$col4 = New-PowerBIColumn -Name Date -DataType DateTime
PS C:\>$col5 = New-PowerBIColumn -Name Detail -DataType String
PS C:\>$col6 = New-PowerBIColumn -Name Result -DataType Double
PS C:\>$table2 = New-PowerBITable -Name SampleTable2 -Columns $col3,$col4,$col5,$col6
PS C:\>
PS C:\>$dataset = New-PowerBIDataSet -Name SampleDataSet -Tables $table1,$table2
PS C:\>
PS C:\>Add-PowerBIDataSet -DataSet $dataset

This example instantiates a table with two columns and another table with four columns, and instantiates a dataset. Then, it creates the dataset in Power BI.

Parameters

-Name

Dataset Name.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Tables

An array of Table objects

Type:Table[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

Microsoft.PowerBI.Common.Api.Datasets.Dataset