FabricTools v0.33.0 Public Preview

Update-FabricCapacity

Creates or updates a Microsoft Fabric capacity.

Syntax

Update-FabricCapacity [-SubscriptionId] <guid> [-ResourceGroupName] <string>
 [-CapacityName] <string> [-SkuName] <string> [-Location] <string>
 [-AdministrationMembers] <string[]> [[-Tags] <hashtable>] [-NoWait] [-WhatIf] [-Confirm]
 [<CommonParameters>]

Description

The Update-FabricCapacity function sends a PATCH request to the Microsoft Fabric API to create or update a capacity in the specified Azure subscription and resource group. It supports parameters for capacity administration, SKU details, and optional tags.

Examples

Example 1

$azureResource = @{
    subscriptionID = 'GUID-GUID'
    ResourceGroup  = 'TestRG'
    CapacityName   = 'fabricblogdemof4'
    Location       = 'uksouth'
}
Update-FabricCapacity @azureResource -SkuName 'F8' -AdministrationMembers 'azsdktest@microsoft.com' -Debug -Confirm:$false

Example 2

$azureResource = @{
    subscriptionID = 'GUID-GUID'
    ResourceGroup  = 'TestRG'
    CapacityName   = 'fabricblogdemof4'
    Location       = 'uksouth'
    SkuName        = 'F8'
    AdministrationMembers = 'azsdktest@microsoft.com'
}
Update-FabricCapacity @azureResource -Tags @{Environment="Production"; Owner="IT Team"} -Confirm:$false

Parameters

NameTypeReq.Pos.PipelineDescription
-AdministrationMembers string[] ✓Required 5 –

An array of administrator user identities for the capacity administration.

-CapacityName string ✓Required 2 –

The name of the Microsoft Fabric capacity. It must be a minimum of 3 characters, and a maximum of 63. Must match pattern: ^[a-z][a-z0-9]*$

-Location string ✓Required 4 –

The Azure region where the capacity is located (e.g., "uksouth").

-ResourceGroupName string ✓Required 1 –

The name of the resource group. The name is case insensitive.

-SkuName string ✓Required 3 –

The name of the SKU level (e.g., "F2").

-SubscriptionId guid ✓Required 0 –

The ID of the target subscription. The value must be a UUID.

-Confirmalias: cf switch Named –

Prompts you for confirmation before running the cmdlet.

-NoWait switch Named –

If specified, the function will not wait for the operation to complete and will return immediately.

Default: False
-Tags hashtable 6 –

Optional resource tags as a hashtable.

-WhatIfalias: wi switch Named –

Runs the command in a mode that only reports what would happen without performing the actions.

This cmdlet also supports the common parameters, such as -Verbose and -ErrorAction. See about_CommonParameters.

Notes

  • Calls Confirm-TokenState to ensure token validity before making the API request.
  • Uses Azure Resource Manager API endpoint for capacity management.

Author: Kamil Nowinski