New-PowerBIColumn

Module:

MicrosoftPowerBIMgmt.Data

Creates a new Power BI column object.

Syntax

New-PowerBIColumn
   -Name <String>
   -DataType <PowerBIDataType>
   [<CommonParameters>]

Description

Initiates the creation of a new Power BI column object. Columns are building blocks for constructing a table object.

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

-DataType

A type of the column.

Type:	PowerBIDataType
Accepted values:	Int64, Double, Boolean, DateTime, String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

A column name.

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

Outputs

Microsoft.PowerBI.Common.Api.Datasets.Column