Set-PowerBITable

Module:

MicrosoftPowerBIMgmt.Data Module

Updates the metadata and schema for the specified Power BI table.

Syntax

DatasetId (Default)

Set-PowerBITable
    -Table <Table>
    -DatasetId <Guid>
    [-WorkspaceId <Guid>]
    [-Workspace <Workspace>]
    [<CommonParameters>]

Dataset

Set-PowerBITable
    -Table <Table>
    -Dataset <Dataset>
    [-WorkspaceId <Guid>]
    [-Workspace <Workspace>]
    [<CommonParameters>]

Description

Updates the metadata and schema for the specified Power BI table. Before you run this command, make sure you log in using Connect-PowerBIServiceAccount

Examples

Example 1

$currentTables = Get-PowerBITable -DatasetId c47f6cff-70de-4837-a094-93a6f26e20bf

$currentTable = $currentTables[0]
$col1 = New-PowerBIColumn -Name Col1 -DataType Int64
$col2 = New-PowerBIColumn -Name Col2 -DataType String
$updatedTable = New-PowerBITable -Name $currentTable.Name -Columns $col1,$col2

Set-PowerBITable -Table $updatedTable -DatasetId c47f6cff-70de-4837-a094-93a6f26e20bf

This example retrieves current table and create new one from the table. Then, it updates the table schema.

Parameters

-Dataset

A dataset where tables are stored.

Parameter properties

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

Parameter sets

Dataset

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

-DatasetId

ID of the dataset where tables are to be stored.

Parameter properties

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

Parameter sets

DatasetId

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

-Table

Table to update the schema.

Parameter properties

Type:	Table
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 to filter the place where table resides.

Parameter properties

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

Parameter sets

(All)

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

-WorkspaceId

ID of the workspace to filter the place where table resides.

Parameter properties

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

Parameter sets

(All)

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

Microsoft.PowerBI.Common.Api.Datasets.Dataset

Microsoft.PowerBI.Common.Api.Workspaces.Workspace

Outputs

Microsoft.PowerBI.Common.Api.Datasets.Dataset