Edit

Share via

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