---
title: "Add-CUUser: Create New VDI App Users"
slug: "add-cuuser-create-new-solve-users"
description: "Create new ControlUp Solve users with the Add-CUUser cmdlet. This allows you to programmatically add new users without using the Real-Time DX Console. "
tags: ["Add-CUUser", "Add new Solve user", "Add ControlUp User", "User Management 8.8", "PowerShell cmdlets"]
updated: 2025-08-10T08:48:19Z
published: 2025-08-10T08:48:19Z
canonical: "support.controlup.com/add-cuuser-create-new-solve-users"
---

> ## 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.

# Add-CUUser: Create New VDI App Users

You can use the **Add-CUUser** PowerShell cmdlet to add new VDI App users by creating a shadow user account in our backend. Note that this cmdlet **doesn't** create a user account for the Real-Time DX Console login. For more information see [troubleshooting](/tim-reorg/docs/add-cuuser-create-new-controlup-users#troubleshooting) below.

## Syntax

```powershell
Add-CUUser [-Upn] <String> [-Email] <String> [-SamAccountName] <String> [-UserDnsDomain] <String> [-FirstName] <String> [-LastName] <String> [<CommonParameters>]
```

## Input Parameters

All input parameters below are **mandatory** and formatted as **Strings**

| Parameter Name | Description |
| --- | --- |
| -Upn | User Principal Name. The UPN consists of two parts: the user account name (usually the user's email address) and the domain name in which the user account is located. |
| -Email | Email address of the new user |
| -SamAccountName | Security Account Manager Account Name. It is a logon name used in Active Directory to uniquely identify a user account within a domain. |
| -UserDnsDomain | Domain Name of the new user |
| -FirstName | First name of the user |
| LastName | Last name of the user |

## How to Add a User

1. Import the **ControlUp.PowerShell.User** module into your PowerShell session:

```powershell
$pathtomodule = (Get-ChildItem "C:\Program Files\Smart-X\ControlUpMonitor\*ControlUp.PowerShell.User.dll" -Recurse | Sort-Object LastWriteTime -Descending)[0]
Import-Module $pathtomodule
```
2. Run the command and add the user, replace the parameter values in the following example with those of your user's:

```powershell
Add-CUUser -Upn johndoe@contoso.com -Email johndoe@contoso.com -SamAccountName jdoe -UserDnsDomain contoso.com -FirstName John -LastName Doe
```

Example input values:![Powershell window displaying Add-CUUser cmdlet input](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-LHY4KVKM.png)
3. If LDAP is configured and the user is assigned the **Use Web Application** permission, you can now connect to the VDI App with this user: ![2-step verification popup for new user](https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-BZAZGNV8.png)

### Troubleshooting

<editor360-custom-block data-preprocessing="true" data-sanitizationtags="b"><p>If the user you create with the <b>Add-CUUser</b> cmdlet isn't automatically allowed to log into the Real-Time DX Console, the following error message appears when the user tries to log in:<br><img src="https://cdn.document360.io/098100b7-b9da-4bea-b4b9-017140ab863e/Images/Documentation/image-F9TZYLDJ.png" alt="image.png" width="500"></p></editor360-custom-block>

To grant a user access to the Console, see [here](/v1/docs/sign-in-to-the-real-time-console).