create-session - Amazon DCV Session Manager
SynopsisOptionsExample
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).

create-session

Creates a new Amazon DCV session with the specified details.

Synopsis

create-session
--name <value>
--owner <value>
--type <value>
[--init-file-path <value>]
[--autorun-file <value>]
[--autorun-file-arguments <value>]
[--max-concurrents-clients <value>]
[--dcv-gl-enabled]
[--permissions-file <value>]
[--requirements <value>]
[--storage-root <value>]
[--enqueue-request <value>]

Options

--name

The name of the session.

Type: String

Required: Yes

--owner

The name of the session owner.

Type: String

Required: Yes

--type

The session type. This is either Console or Virtual.

Type: Choice

Required: Yes

--init-file-path

The path to the custom script on the Amazon DCV server to run for initializing the session when it's created. The file path is relative to the init directory specified for the agent.init-folder Agent configuration parameter.

Type: String

Required: No

--autorun-file

The path to a file on the host server that's to be run inside the session. The file path is relative to the autorun directory specified for the agent.autorun-folder Agent configuration parameter.

Type: String

Required: No

--autorun-file-arguments

The command-line arguments passed to AutorunFile when it's run inside the session.

Type: String

Required: No

--max_concurrent-clients

The maximum number of concurrent Amazon DCV clients. If provided, this must be between 1 and 100.

Type: Integer

Required: No

--dcv-gl-enabled

Configures the virtual session to use hardware-based OpenGL. It's disabled by default.

Type: Boolean

Required: No

--permissions-file

The path to the permissions file.

Type: String

Required: No

--requirements

The requirements that the server must meet to place the session.

Type: String

Required: No

--storage-root

The path to the folder used for session storage.

Type: String

Required: No

--enqueue-request

Indicates whether to queue the request if it cannot be immediately fulfilled. Requests are not enqueued by default.

Type: Boolean

Required: No

Example

dcvsm create-session --name session123 --owner sessionOwner
--type Console --requirements "server:Host.Os.Family = 'windows'"