new_rs_env

Use the new_rs_env command to create a new restricted shell environment for the current zone and set the new restricted shell environment as the currently selected restricted shell environment stored in memory. The new restricted shell environment has no field values set.

The new_rs_env command does not save the new restricted shell environment to Active Directory. To save the new restricted shell environment to Active Directory, you must use the save_rs_env command. If you don’t save a new restricted shell environment, it will disappear when you select another restricted shell environment or when the ADEdit session ends.

You can only use the new_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

new_rs_env name

Abbreviation

newrse

Options

This command takes no options.

Arguments

This command takes the following argument:

Argument Type Description
name string Required. Specifies the name to assign to the new restricted shell environment.

Return Value

This command creates a new restricted shell environment in the currently selected zone.

Examples

new_rs_envs rse3

This example creates a new restricted environment named rse3 in the current zone.

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.
  • select_rs_env retrieves a restricted shell environment from Active Directory 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.