---
title: "PowerShell Cmdlets to Breakdown Azure Connections"
slug: "powershell-cmdlets-to-breakdown-connections-to-resource-groups"
updated: 2025-07-03T11:11:10Z
published: 2025-07-03T11:11:10Z
canonical: "support.controlup.com/powershell-cmdlets-to-breakdown-connections-to-resource-groups"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.controlup.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PowerShell Cmdlets to Breakdown Azure Connections

You can create multiple Azure cloud connections for the same subscription. This enables you to assign specific resource groups to each connection to improve data collection granularity and accuracy. To optimize performance, utilize data collectors closer to your virtual endpoints, and configure different monitor sites for each connection.

Version 9.1 includes the following PowerShell cmdlets to break down your cloud data connections to resource groups. You can then add multiple connections for the same subscription to your organizational tree, with no need to use the ControlUp Real-Time DX Console. You can configure each connection to collect data from specific resource groups, enabling you to assign a dedicated data collector and define specific sites for each connection.

The **ControlUp.PowerShell.User** module contains the PowerShell cmdlets mentioned in this article.

To break down your cloud data connections to resource groups with the Real-Time DX Console, see [here](/v1/docs/breakdown-cloud-connections).

## What's New?

With these PowerShell cmdlets, you can:

- [Get a list](/v1/docs/powershell-cmdlets-to-breakdown-connections-to-resource-groups#getcucloudconnectionbreakdownrules) of all the breakdown rules for a specific cloud connection
- [Update](/v1/docs/powershell-cmdlets-to-breakdown-connections-to-resource-groups#updatecucloudconnectionbreakdownrules) the breakdown rules of a specific cloud connection

You configure cloud connections according to the following flow:

1. [Create cloud connection](/v1/docs/azure-integration-getting-started#add-azure-connection-using-powershell) with a specified data collector.

2. [Configure cloud connection](/v1/docs/powershell-cmdlets-to-breakdown-connections-to-resource-groups#updatecucloudconnectionbreakdownrules) breakdown rules.

## Prerequisites

- ControlUp Monitor version 9.1
- The **Manage All Cloud Connections** permission must be granted in the console [Security Policy](/v1/docs/security-policy-pane).

## Get-CUCloudConnectionBreakdownRules

Lists the configured breakdown rules of a specific connection. The list includes the details of the regions, resource groups, and any other breakdown rules that have been configured.

**Syntax**

```powershell
Get-CUCloudConnectionBreakdownRules -ConnectionId <String>
```

**Example**

```powershell
Get-CUCloudConnectionBreakdownRules -ConnectionId 71fa1a7c-cbb5-47e8-9775-ec49e9547c9c
```

**Parameters**

| Parameters | Description | Required |
| --- | --- | --- |
| -ConnectionId | Unique ID for this cloud connection | Yes |

### Get-CUCloudConnectionBreakdownRules Results

Returns a list of all configured breakdown rules of a specific connection, with the following properties:

```powershell
SelectedRegions: <String>
ResourceGroupWildCard: <String> 
IncludedRG: <String>
ExcludedRG: <String>
```

## Update-CUCloudConnectionBreakdownRules

Updates the breakdown rules of a specific connection, including selecting specific regions, applying a wildcard for resource group names, and specifying included or excluded resource groups. You must configure a wildcard pattern for resource groups in different regions, or you can manually select resource groups to add to the connection. First you select specific resource groups from an Azure subscription, and then you can assign a dedicated data collector from the site that you define that will only collect data from the included resource groups that you define.

**Syntax**

```powershell
Update-CUCloudConnectionBreakdownRules -ConnectionId <String> [-SelectedRegions <String[]>] [-ResourceGroupWildCard <String>] [-IncludedRG <String[]>] [-ExcludedRG <String[]>]
```

**Example**

```powershell
Update-CUCloudConnectionBreakdownRules -ConnectionId 71fa1a7c-cbb5-47e8-9775-ec49e9547c9c -SelectedRegions "eastus" -ResourceGroupWildCard "rg-a*" -IncludedRG "cu-dev-ea (1)\eastus\rg-auto-streaming", "cu-dev-ea (1)\eastus\rg-avd-qa" -ExcludedRG "cu-dev-ea (1)\westeurope\aicontestresourcegroupeu", "cu-dev-ea (1)\westeurope\rg-security"
```

**Parameters**

| Parameters | Description | Required |
| --- | --- | --- |
| -ConnectionId | Unique ID for this cloud connection | Yes |
| -SelectedRegions | Specific regions assigned to the connection | No |
| -ResourceGroupWildCard | Wildcard pattern of the names of the resource groups assigned to the connection | No |
| -IncludedRG | Names of the resource groups included in the connection | No |
| -ExcludedRG | Names of the resource groups excluded from the connection | No |

### Update-CUCloudConnectionBreakdownRules Results

Writes single result object to PowerShell with the following properties:

- Error. In case of failure, the reason will be displayed.
- Success. In case of success, all updated parameters will be displayed, for example:![Powershell window displaying Update-CUCloudConnectionBreakdownRules output Results](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/Update-CUCloudConnectionBreakdownRules.png)