Managing Amazon DCV Session authorization - Amazon DCV
SyntaxOptionsExamples
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Managing Amazon DCV Session authorization

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 --session session-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 --session my-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 --session my-session --file c:\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 --session my-session --reset-builtin