--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:

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

or

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:

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

or

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:

role.exe --info webmaster -owner JDoe

or

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:

role.exe --delete webmaster -owner JDoe

or

role.exe -d webmaster -owner JDoe

--list-sp or -l

-owner <username>

Shows the information about applications installed on a user's subscription.

The XML-formatted output contains the <permission-id> tags which enclose the ID number of the permission. You should use that ID number if you want to allow access to the application for a user role.

To view the information about applications installed on the subscription of the customer with username JDoe:

>role -l -owner JDoe

--update-sp or -s

<role name> -owner <username> -servicePermissionId <ID number> -servicePermissionState <true|false>

Updates permissions to access installed applications for a user role.

To allow the user role webmaster created for the customer with username JDoe to access the application with ID 3:

role.exe --update-sp webmaster -owner JDoe -servicePermissionId 3 -servicePermissionState true

--help or -h

Displays help on the utility use.

To view help on the use of this utility:

role.exe --help

or

role.exe -h

-servicePermissionId

<number>

ID of a permission to access and manage an installed application. Can be retrieved with the command --list-sp.

To allow the user role webmaster created for the customer with username JDoe to access the application with ID 3:

role.exe --update-sp webmaster -owner JDoe -servicePermissionId 3 -servicePermissionState true

-servicePermissionState

true|false

State of a permission (granted or prohibited).

-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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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:

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

-applicationsManagement

true|false

The permission to install applications on websites.

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

role.exe -u webmaster -owner JDoe -applicationsManagement true

-sitebuilderManagement

true|false

The permission to create and update sites with Presence Builder.

To grant the permission to create and update sites with Presence Builder to the role webmaster created for the customer with the username JDoe:

role.exe -u webmaster -owner JDoe -sitebuilderManagement 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:

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

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

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:

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:

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:

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:

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

-publishFilesOnTheWeb

true|false

The permission to share files with other users or anyone on the Web.

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

role.exe -u webmaster -owner JDoe -publishFilesOnTheWeb true