list_rs_envs

Use the list_rs_envs command to check Active Directory and print a list of restricted shell environments defined within the currently selected zone to stdout. Use the get_rs_envs command to return a Tcl list.

Zone Type

Classic only

Syntax

list_rs_envs

Abbreviation

lsrse

Options

This command takes no options.

Arguments

This command takes no arguments.

Return Value

This command prints the list of restricted shell environments to stdout. It has no return value.

Examples

list_rs_envs

This example displays the list of restricted shell environments.

restrict_env1

restrict_env2

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.
  • new_rs_env creates a new restricted shell environment and stores it in memory.
  • 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.

list_zone_computers

Use the list_zone_computers command to check Active Directory and return a list of zone computers defined within the currently selected zone. If executed in a script, this command outputs its list to stdout so that the output appears in the shell where the script is executed. The command does not return a Tcl list back to the executing script. Use get_zone_computers to return a Tcl list.

Zone Type

Classic and hierarchical

Syntax

list_zone_computers

Abbreviation

lszc

Options

This command takes no options.

Arguments

This command takes no arguments.

Return Value

This command returns a list to stdout of zone computers defined in the currently selected zone. Each zone computer entry includes the following fields, separated by colons (:) :

  • User principal name (UPN) of the computer.
  • Number of CPUs in the computer and the version of Delinea software installed on the computer.
  • Name of the computer in DNS.

Examples

list_zone_computers

This example returns the list of computers similar to this:

printserv$@acme.com:cpus (1) agentVersion (CentrifyDC 5.0.0): printserv.acme.com

Before you use this command, you must have a currently selected zone stored in memory. The following commands enable you to view and select a zone computer:

  • get_zone_computers returns a Tcl list of the Active Directory names of all zone computers in the current zone.
  • new_zone_computer creates a new zone computer and stores it in memory.
  • select_zone_computer retrieves a zone computer from Active Directory and stores it in memory.

After you have a zone computer stored in memory, you can use the following commands to work with that zone computer:

  • delete_zone_computer deletes the zone computer from Active Directory and from memory.
  • get_zone_computer_field reads a field value from the currently selected zone computer.
  • save_zone_computer saves the zone computer with its current settings to Active Directory.
  • set_zone_computer_field sets a field value in the currently selected zone computer.