Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Administration: roles and access

This page describes the devo admin role and devo admin access commands, which show security roles and permission sets and manage the organization-wide permissions of users and groups. Most of them are for Devolutions Cloud; devo admin access permission-sets is for Devolutions Server. The Workspace line under each command says where it works. A command run on a workspace type it doesn't support stops with operationNotSupportedBySource and names the type you need.

For the list of all commands, see Commands. For step-by-step tasks, see Manage users, groups, and access. To give access to one vault or one entry, use devo vault access and devo entry access instead. The options every command accepts, such as --context or --output json, are described in Global options and aren't repeated here.

IDs. Every ID on this page (user, group, role) is a GUID. Find user IDs with devo admin user list, group IDs with devo admin group list, and role IDs with devo admin role list. Commands that change something refuse to run without --yes (aliases -y and --confirmed) and stop with confirmationRequired.

devo admin role list

Lists the vault roles or the entry roles of the Devolutions Cloud organization. Alias: devo admin role ls.

Workspace: Devolutions Cloud.

devo admin role list [--scope vault|entry]
OPTION
DEFAULT
WHAT IT DOES

--scope <scope>

vault

Which roles to list: vault (roles you assign on a vault) or entry (roles you assign on an entry). Any other value is refused. Case doesn't matter.

devo admin role get

Shows one vault role or entry role, by ID.

Workspace: Devolutions Cloud.

devo admin role get <role-id> [--scope vault|entry]
OPTION
DEFAULT
WHAT IT DOES

<role-id>

Required. ID of the role, as a GUID.

--scope <scope>

vault

Where to look for the role: vault or entry. Use the scope the role belongs to. Any other value is refused.

devo admin access permission-sets

Lists the permission sets of the workspace.

Workspace: Devolutions Server.

This command has no options of its own.

devo admin access system list

Lists the system permissions given to users and groups of the Devolutions Cloud organization. Alias: devo admin access system ls.

Workspace: Devolutions Cloud.

This command has no options of its own.

devo admin access system get

Shows the system permissions of one user or one group.

Workspace: Devolutions Cloud.

OPTION
DEFAULT
WHAT IT DOES

--user-id <id>

ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.

--group-id <id>

ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.

devo admin access system grant

Gives one or more system permissions to a user or a group.

Workspace: Devolutions Cloud.

OPTION
DEFAULT
WHAT IT DOES

--user-id <id>

ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.

--group-id <id>

ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.

--permission <name>

Required. System permission to give. Repeat the option, or list several names after one --permission, to give several. Names are matched without case sensitivity and duplicates are ignored. Only the names listed below are accepted; an unknown or empty name is refused.

--yes (-y, --confirmed)

Off

Confirms the change. Required.

devo admin access system revoke

Removes system permissions from a user or a group. Without --permission, removes all of the subject's system permissions. Alias: devo admin access system rm.

Workspace: Devolutions Cloud.

OPTION
DEFAULT
WHAT IT DOES

--user-id <id>

ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.

--group-id <id>

ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.

--permission <name>

All

System permission to remove. Repeat the option, or list several names, to remove several. Leave it out to remove every system permission of the user or group. Only the names listed below are accepted.

--yes (-y, --confirmed)

Off

Confirms the removal. Required.

System permission names

--permission accepts these names, without case sensitivity:

  • Organization and settings: manageSystemSettings, systemSettingsView, manageLicense, manageProductLicenses, viewAdministrationLogs, openedEntriesView, forceCheckin, releaseLock.

  • Vaults and templates: addVaults, manageEntryTemplates, entryTemplatesView, entryTemplatesEdit, entryTemplatesDelete, managePasswordTemplates, passwordTemplatesView, passwordTemplatesAdd, passwordTemplatesEdit, passwordTemplatesDelete, passphraseDictionariesEdit, passphraseDictionariesDelete.

  • Users, groups, and invitations: manageUsersGroups, manageUsers, usersView, usersAdd, usersEdit, usersDelete, usersReinvite, groupsView, groupsAdd, groupsEdit, groupsDelete, manageInvitations, invitationsView, invitationsAdd, invitationsDelete.

  • Licenses: licensesAssign, licensesView, licensesAdd, licensesAdjust, licensesDelete.

  • Devolutions Gateway: manageGateways, gatewaysView.

  • Privileged access: managePAMProviders, pamProvidersView, managePAMTasks, addPAMVaults, managePAMPolicies, pamPoliciesView, managePAMScriptTemplates, pamScriptTemplatesView.

  • Global resources: manageGlobalImages, manageGlobalMacrosScriptsTools, manageGlobalVpns, manageGlobalContact, manageCustomWidgets.

  • Application services: manageApplicationServices, applicationServicesView, applicationServicesAdd, applicationServicesEdit, applicationServicesDelete, applicationServicesChangeStatus, applicationServicesViewLogs.

  • Scheduled reports: manageScheduledReports, scheduledReportsView, scheduledReportsAdd, scheduledReportsEdit, scheduledReportsDelete, scheduledReportsReschedule.

devo admin access system-vault list

Lists the roles users and groups hold on the system vault of the Devolutions Cloud organization. Alias: devo admin access system-vault ls.

Workspace: Devolutions Cloud.

This command has no options of its own.

devo admin access system-vault get

Shows the system vault role of one user or one group.

Workspace: Devolutions Cloud.

OPTION
DEFAULT
WHAT IT DOES

--user-id <id>

ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.

--group-id <id>

ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.

devo admin access system-vault grant

Gives a user or a group a role on the system vault. If the user or group already has a role there, it's replaced.

Workspace: Devolutions Cloud.

OPTION
DEFAULT
WHAT IT DOES

--user-id <id>

ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.

--group-id <id>

ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.

--role-id <role-id>

Required. ID of the vault role to give, as a GUID. Find it with devo admin role list --scope vault.

--yes (-y, --confirmed)

Off

Confirms the change. Required.

devo admin access system-vault revoke

Removes the system vault role of a user or a group. Alias: devo admin access system-vault rm.

Workspace: Devolutions Cloud.

OPTION
DEFAULT
WHAT IT DOES

--user-id <id>

ID of the user, as a GUID. Pass exactly one of --user-id and --group-id.

--group-id <id>

ID of the group, as a GUID. Pass exactly one of --user-id and --group-id.

--yes (-y, --confirmed)

Off

Confirms the removal. Required.

Last updated

Was this helpful?