Authorization is used to grant or deny Amazon DCV clients permissions to specific Amazon DCV features. Typically, authorization is configured when a Amazon DCV session is started. However, it's possible to edit the permissions for a running session. For more information about Amazon DCV authorization, see Configuring Amazon DCV authorization.
To modify the permissions for a running session, use the dcv set-permissions command.
Syntax
dcv set-permissions --sessionsession-id--none | --reset-builtin | --file/path_to/permissions_file
You must specify either --none, --reset-builtin, or --file.
Options
The following options can be used with the dcv set-permissions command.
- --session
-
Specifies the ID of the session to set the permissions for.
- --reset-builtin
-
Resets the session's permissions to the default session permissions. The default permissions grants only the session owner full access to all features.
- --none
-
Revokes all permissions for the session.
- --file
-
Specifies the path to a custom permissions file. If the specified file is empty, all permissions are revoked. For more information about creating a custom permissions file, see Understanding permissions files.
Examples
Example 1—Revoking all permissions
The following example revokes all client permissions for a session with an ID of my-session.
C:\>dcv set-permissions --sessionmy-session--none
Example 2—Specifying custom permissions
The following example specifies a custom permissions file that's named perm-file.txt for a session with an ID
of my-session. This file is located in the c:\dcv\ directory.
C:\>dcv set-permissions --sessionmy-session--filec:\dcv\perm-file.txt
Example 3—Resetting the permissions
The following example resets the permissions to the defaults for a session with an ID of my-session.
C:\>dcv set-permissions --sessionmy-session--reset-builtin
