---
title: "PowerShell Cmdlets for Sites Management"
slug: "powershell-cmdlets-for-sites-management"
updated: 2026-02-11T11:58:18Z
published: 2026-02-11T11:58:18Z
canonical: "support.controlup.com/powershell-cmdlets-for-sites-management"
---

> ## 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 for Sites Management

Version 9.1 and higher includes the following PowerShell cmdlets to manage your ControlUp Monitor sites, with no need to use the Real-Time DX Console. From version 9.1, if you use an [Independent Sites](/v1/docs/introduction-to-controlup-monitor-clusters#independent-sites-for-large-organizations) configuration, use these cmdlets to quickly and efficiently configure your sites.

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

> [!NOTE]
> Version Compatibility
> 
> For the best stability and performance, ensure that all ControlUp Monitor nodes in your environment are running the same Monitor version. This applies whether you use **Independent Sites** mode or the traditional monitor configuration.

## What's New?

With these PowerShell cmdlets, you can do the following:

- [Get a list](/v1/docs/powershell-cmdlets-for-sites-management#getcusites) of all your monitor sites
- [Create](/v1/docs/powershell-cmdlets-for-sites-management#addcusite), [update](/v1/docs/powershell-cmdlets-for-sites-management#updatecusite), or [delete](/v1/docs/powershell-cmdlets-for-sites-management#removecusite) monitor sites

## Prerequisites

- ControlUp Monitor version 9.1
- The **Add Site**, **Remove Site**, **Update Site**, and **View Site** permissions must be granted in the console [Security Policy](/v1/docs/security-policy-pane).

### Get-CUSites

Lists details for all existing sites configured in your organization.

**Syntax**

```powershell
Get-CUSites
```

### Get-CUSites Results

Returns a list of all configured monitor sites in your organization, with the following properties for each site:

```powershell
-SiteId <String> [-SiteName <String>] [-Description <String>] [-IsGlobal]
```

### Add-CUSite

Creates a new monitor site in your organization. You must specify a site name.

**Syntax**

```powershell
Add-CUSite -SiteName <String> [-Description <String>] [-IsGlobal]
```

**Example**

```powershell
Add-CUSite -SiteName NewSiteName -Description "Test description 1" -IsGlobal
```

**Parameters**

| **Parameters** | Description | Required |
| --- | --- | --- |
| -SiteName | Name of the site | Yes |
| -Description | Description of site | No |
| -IsGlobal | If provided, defines the site as the global site. Only a single site in your organization can be global. | No |

### Update-CUSite

Updates the properties of a specific site in your organization. You can modify the site name, description, and global status.

**Syntax**

```powershell
Update-CUSite -SiteId <String> [-Description <String>] [-IsGlobal] [-SiteName <String>]
```

**Example**

```powershell
Update-CUSite -SiteId 67263707-7f3d-4f3a-9874-a2dc638fba2f -Description "New description" -IsGlobal -SiteName "Edited site name"
```

**Parameters**

| **Parameters** | Description | Required |
| --- | --- | --- |
| -SiteId | ID of the site | Yes |
| -SiteName | Name of the site | No |
| -Description | Description of site | No |
| -IsGlobal | If provided, defines the site as a global site. Only a single site in your organization can be global. | No |

### Add-CUSite & Update-CUSite 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, the site ID and site name will be displayed.

### **Remove-CUSite**

Deletes an existing site from your organization. Note that you can't remove all sites from your organization, at least one must remain.

**Syntax**

```powershell
Remove-CUSite -SiteId <String>
```

**Example**

```powershell
Remove-CUSite -SiteId 67263707-7f3d-4f3a-9874-a2dc638fba2f
```

**Parameters**

| **Parameters** | Description | Required |
| --- | --- | --- |
| -SiteId | ID of the site | Yes |

###