Skip past navigation linksSecure Global Desktop Administration Guide > Commands > The tarantella emulatorsession shadow command

The tarantella emulatorsession shadow command

Syntax

Skip past command syntax or program codetarantella emulatorsession shadow sessid
                                  [--read-only]
                                  [--silent]
                                  [--format text|quiet]

Description

Shadows an emulator session, allowing you and the user to interact with the application simultaneously. Only Secure Global Desktop Administrators may shadow emulator sessions. You can only shadow Windows and X applications.

Note You can also shadow a session from the Sessions tab in Object Manager. You select the session from either the person object or the application object. However, Object Manager does not allow you to shadow a session in read-only mode or silent mode.

If --silent is not used, the user is notified that an Administrator wants to shadow their session and they can refuse permission. The user is also notified when shadowing ends.

Option Description
sessid Shadows the emulator session with the specified session ID. Use tarantella emulatorsession list to find out session IDs.
--read-only Allows an Administrator to shadow a session without being able to interact with the application.
--silent Allows an Administrator to shadow a session and interact with the application. The user is not notified that an Administrator wants to shadow their session and they can't refuse permission.

If this is used with --read-only, the user does not know they are being shadowed and the Administrator can't interact with the application.

Note In some countries, it is illegal to shadow a user without their knowledge. It is your responsibility to comply with the law.

--format text | quiet Specifies the output format (default: text). With --format quiet, no messages are displayed.

The exit code is 0 for success, 1 if the session doesn't exist, 2 if the session isn't shadowable, or 3 if the session is suspended.

Examples

Skip past command syntax or program codetarantella emulatorsession shadow \
  "paris.indigo-insurance.com:965127448604:...%2f_ens%2fo=Indigo Insurance%2fcn=Emma Rald"

Shadows the emulator session with the specified session ID.

Skip past command syntax or program codetarantella emulatorsession shadow \
  "paris.indigo-insurance.com:965127448604:...%2f_ens%2fo=Indigo Insurance%2fcn=Emma Rald" \
--read-only --silent

Shadows the emulator session with the specified session ID without the user knowing that they are being shadowed. The Administrator is unable to interact with the application.

Related topics