New-AzureRmPowerBIEmbeddedCapacity

Creates a new 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

New-AzureRmPowerBIEmbeddedCapacity
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [-Sku] <String>
   [-Administrator] <String[]>
   [-Tag <Hashtable>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-AzureRmPowerBIEmbeddedCapacity cmdlet creates a new PowerBI Embedded Capacity

Examples

Example 1

PS C:\> New-AzureRmPowerBIEmbeddedCapacity -ResourceGroupName "testRG" -Name "testcapacity" -Location "West Central US" -Sku "A1" -Administrator admin@microsoft.com
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          : {admin@microsoft.com}
Sku                    : A1
Tier                   : PBIE_Azure
Tag                    : {}

Creates a capacity named testcapacity in the Azure region West Central US and in resource group testRG. The sku level for the capacity will be A1.

Parameters

-Administrator

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

Type:String[]
Position:4
Default value:None
Accept pipeline input:True
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

-Location

The Azure region where the PowerBI Embedded Capacity is hosted

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

-Name

Name of the PowerBI Embedded Capacity

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

-ResourceGroupName

Name of the Azure resource group to which the capacity belongs

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:3
Default value:None
Accept pipeline input:True
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:True
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

String[]

Hashtable

Outputs

PSPowerBIEmbeddedCapacity