select_rs_env

Use the select_rs_env command to retrieve a restricted shell environment in the currently selected zone from Active Directory, stores it in memory, and sets it to be the currently selected restricted shell environment for other ADEdit commands. The restricted shell environment remains selected until you select another restricted shell environment, change the currently selected zone, delete the restricted shell environment, or end the ADEdit session.

If you use ADEdit commands such as set_rse_field to change settings for the restricted shell environment, you must save the restricted shell environment using the save_rs_env command for your changes to take effect in Active Directory. If you select another restricted shell environment or end the ADEdit session before saving the currently selected restricted shell environment, your changes will be lost.

You can only use the select_rs_env command if the currently selected zone is a classic4 zone. The command does not work in other types of zones.

Zone type

Classic only

Syntax

select_rs_env rse_name

Abbreviation

slrse

Options

This command takes no options.

Arguments

This command takes the following argument:

Argument Type Description

rse_name

string

Required. Specifies the name of the restricted shell environment to select.

Return value

This command returns nothing if it runs successfully.

Examples

select_rs_env rse1

This command looks for the restricted shell environment named rse1 in the current zone. If rse1 is found in the current zone, it becomes the currently selected context for subsequent commands.

Related commands

Before you use this command, you must have a currently selected role stored in memory. The following commands enable you to view and select the role to work with restricted shell environments:

  • get_rs_envs returns a Tcl list of restricted shell environments.
  • list_rs_envs lists to stdout the restricted shell environments.
  • new_rs_env creates a new restricted shell environment and stores it in memory.

After you have a restricted shell environment stored in memory, you can use the following commands to work with its fields:

  • delete_rs_env deletes the current restricted shell environment from Active Directory and from memory.
  • get_rse_field reads a field value from the current restricted shell environment.
  • save_rs_env saves the restricted shell environment to Active Directory.
  • set_rse_field sets a field value in the current restricted shell environment.