Update-AzureRmPowerBIEmbeddedCapacity

Modifies an instance of PowerBI Embedded Capacity.

Caution

Because Az PowerShell modules now have all the capabilities of AzureRM PowerShell modules and more, we'll retire AzureRM PowerShell modules on 29 February 2024.

To avoid service interruptions, update your scripts that use AzureRM PowerShell modules to use Az PowerShell modules by 29 February 2024. To automatically update your scripts, follow the quickstart guide.

Syntax

Update-AzureRmPowerBIEmbeddedCapacity
      [-Name] <String>
      [-ResourceGroupName <String>]
      [-Sku <String>]
      [-Tag <Hashtable>]
      [-Administrator <String[]>]
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzureRmPowerBIEmbeddedCapacity
      [-Sku <String>]
      [-Tag <Hashtable>]
      [-Administrator <String[]>]
      [-ResourceId] <String>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzureRmPowerBIEmbeddedCapacity
      [-Sku <String>]
      [-Tag <Hashtable>]
      [-Administrator <String[]>]
      [-InputObject] <PSPowerBIEmbeddedCapacity>
      [-PassThru]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Update-AzureRmPowerBIEmbeddedCapacity cmdlet modifies an instance of PowerBI Embedded Capacity

Examples

Example 1

PS C:\> Update-AzureRmPowerBIEmbeddedCapacity -Name "testcapacity" -Tag @{"key1" = "value1";"key2" = "value2"} -Administrator "testuser1@contoso.com, testuser2@contoso.com" -PassThru
Type                   : Microsoft.PowerBIDedicated/capacities
Id                     : /subscriptions/78e47976-.../resourceGroups/testRG/providers/Microsoft.PowerBIDedicated/capacities/testcapacity
ResourceGroup          : testRG
Name                   : testcapacity
Location               : West Central US
State                  : Succeeded
Administrator          : {testuser1@contoso.com, testuser2@contoso.com}
Sku                    : A1
Tier                   : PBIE_Azure
Tag                    : {[key1, value1], [key2, value2]}

Modifies the capacity named testcapacity in resourcegroup testgroup to set the tags as key1:value1 and key2:value2 and administrator to testuser1@contoso.com

Parameters

-Administrator

A comma separated capacity names to set as administrator on the capacity

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

-Confirm

Prompts user to confirm whether to perform the operation

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Input object for Piping

Type:PSPowerBIEmbeddedCapacity
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Name

Name of the PowerBI Embedded Capacity

Type:String
Position:0
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Will return the deleted capacity details if the operation completes successfully

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Name of the Azure resource group to which the capacity belongs

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

-ResourceId

PowerBI Embedded Capacity ResourceID.

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

-Sku

The name of the Sku for the capacity.

Type:String
Accepted values:A1, A2, A3, A4, A5, A6
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Tag

Key-value pairs in the form of a hash table set as tags on the capacity.

Type:Hashtable
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Describes the actions the current operation will perform without actually performing them

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Inputs

String

PSPowerBIEmbeddedCapacity

Parameters: InputObject (ByValue)

Outputs

PSPowerBIEmbeddedCapacity