The `role.exe` utility is used for managing roles for additional Plesk users.
## Location `%plesk_cli%`
## Usage 
role.exe <command> [<login_name>] [
<option_1> [<param>]
[<option_2> [<param>]]
... [<option_N> [<param>]]
## Example The following command creates a user role named *webmaster* for the customer with the username *JDoe.* The role allows the customer’s users created by that role to manage websites under the customer’s subscription. 
plesk bin role.exe --create webmaster -owner JDoe -webSitesAndDomainsManagement true
## Commands

Command

Parameter

Description

Example

--create or -c

<role name>

Creates a user role.

Requires the -owner option.

To create a role named webmaster for the customer with the username JDoe:

plesk bin role.exe --create webmaster -owner JDoe -webSitesAndDomainsManagement true

or

plesk bin role.exe -c webmaster -owner JDoe -webSitesAndDomainsManagement true

--update or -u

<role name>

Updates user role properties.

To revoke the permission to manage websites from the role webmaster created for the customer with the username JDoe:

plesk bin role.exe --update webmaster -owner JDoe -webSitesAndDomainsManagement false

or

plesk bin role.exe -u webmaster -owner JDoe -webSitesAndDomainsManagement false

--info or -i

<role name>

Displays information about a user role.

To retrieve information about a user role named webmaster created for the customer with the username JDoe:

plesk bin role.exe --info webmaster -owner JDoe

or

plesk bin role.exe -i webmaster -owner JDoe

--delete or -d

<role name>

Removes a user role.

To remove a user role named webmaster that was created for the customer with the username JDoe:

plesk bin role.exe --delete webmaster -owner JDoe

or

role.exe -d webmaster -owner JDoe

--help or -h

Displays help on the utility use.

To view help on the use of this utility:

plesk bin role.exe --help

or

plesk bin role.exe -h
## Options

Option

Parameter

Description

Example

-owner

<username>

The Plesk user for which the role is created, modified, or removed.

To view the information about a user role named webmaster created for the customer with the username JDoe:

plesk bin role.exe --info webmaster -owner JDoe

-userManagement

true|false

The permission to manage users and roles through Control Panel.

To grant the permission to manage users and roles to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - userManagement true

-webSitesAndDomainsManagement

true|false

The permission to create and manage websites through Control Panel.

To grant the permission to create and manage websites to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - webSitesAndDomainsManagement true

-logRotationManagement

true|false

The permission to manage log files and log recycling settings.

To grant the permission to manage log files to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - logRotationManagement true

-anonymousFtpManagement

true|false

The permission to set up FTP shares accessible to the Internet users without password authentication. Available only for subscriptions on dedicated IP addresses.

To grant the permission to set up an FTP share accessible without password to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - anonymousFtpManagement true

-scheduledTasksManagement

true|false

The permission to schedule execution of scripts on the server.

To grant the permission to schedule execution of scripts to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - scheduledTasksManagement true

-spamfilterManagement

true|false

The permission to configure spam filtering settings for individual accounts.

To grant the permission to adjust spam filter setting to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe -spamfilterManagement true

-antivirusManagement

true|false

The permission to configure antivirus settings for individual accounts.

To grant the permission to configure antivirus settings to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe -antivirusManagement true

-databasesManagement

true|false

The permission to create and manage databases.

To grant the permission to create and manage databases to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe -databasesManagement true

-backupRestoreManagement

true|false

The permission to back up and restore websites by using the Control Panel’s backup and restore functions.

To grant the permission to back up and restore sites to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe -backupRestoreManagement true

-browseStats

true|false

The permission to view various statistics and account information shown on the Statistics tab of Control Panel.

To grant the permission to view statistics and account information to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe -browseStats true

-filesManagement

true|false

The permission to upload and manage files through Control Panel’s File Manager.

To grant the permission to manage site files through File Manager to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - filesManagement true

-ftpAccountsManagement

true|false

The permission to set up and manage additional FTP accounts for access to the subscription.

To grant the permission to set up and manage additional FTP accounts to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - ftpAccountsManagement true

-dnsManagement

true|false

The permission to change DNS zone settings for websites.

To grant the permission to change DNS settings to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - dnsManagement true

-javaApplicationsManagement

true|false

The permission to install third-party Java applications packaged in WAR format.

To grant the permission to install Java applications to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - javaApplicationsManagement true

-mailManagement

true|false

The permission to create and manage mail accounts.

To grant the permission to create and manage mail accounts to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - mailManagement true

-mailListsManagement

true|false

The permission to create and manage mailing lists.

To grant the permission to create and manage mailing lists to the role webmaster created for the customer with the username JDoe:

plesk bin role.exe -u webmaster -owner JDoe - mailListsManagement true