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.