---
title: "role create"
slug: "role-create"
tags: ["5.4"]
updated: 2026-10-28T01:52:52Z
published: 2026-10-28T01:52:52Z
canonical: "docs.vastdata.com/role-create"
---

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

# role create

This command creates an administrative role.

##### Usage

```plaintext
role create --name NAME
           [--ldap-groups GROUPS]
           [--tenant-ids IDs]
```

##### Required Parameters

| `--name NAME` | Specifies the name of the role. |
| --- | --- |

##### Options

| `--ldap-groups GROUPS` | Specifies one or more groups to associate the group(s) with the role. Users who belong to groups that are associated with the role will be able to log into VMS using their LDAP user name and password. They will be authorized based on the role(s) associated with their group. Each group can be any group on any connected LDAP-based provider, including Active Directory. Groups can be associated with multiple roles and vice versa. |
| --- | --- |
| `--tenant-ids IDs` | Determines the tenant(s) for the role. You can specify one tenant ID or a comma-separated list of tenant IDs. |

##### Example

This example creates a role named *mynewrole* on tenant 2:

```plaintext
vcli: admin> role create --name mynewrole --tenant-ids 2
```