C Terminal Services Profile Field Names for Reconciliation and Provisioning

Note:

The information in this appendix is applicable only to the Microsoft Active Directory target system and only if you are going to use the target system as a target resource.

Microsoft Active Directory stores the following user information in BLOB format:

  • Environment

  • Remote Control

  • Sessions

  • Terminal Services Profile

As mentioned earlier in this guide, reconciliation and provisioning scripts are used to work with the Terminal Services Profile fields of the target system. Although only the Terminal Services Profile fields are supported by default, the scripts contain code that can handle fields of the remaining three categories.

Table 1-4 lists the fields that are supported for target resource reconciliation, and Table 1-8 lists the fields that are supported for provisioning. If required, you can add new fields for reconciliation and provisioning.

Chapter 4, "Extending the Functionality of the Connector" describes the procedure to add new fields. One of the steps of the procedure is to determine the target system name of the field that you want to add. However, if you want to add an Environment, Remote Control, or Sessions field, then you must use the field names defined in the reconciliation and provisioning scripts. Table C-1 lists these fields and the values that the scripts accept during provisioning and reconciliation. While performing the procedure described in Chapter 4, use the field names given in the "Name of the Field in the Scripts" column of the table.

Table C-1 Terminal Services Profile Fields Included in the Reconciliation and Provisioning Scripts

User Information Tab in Microsoft Active Directory Name of the Field in the Scripts Values That the Field Can Take

Remote Control

EnableRemoteControl

The value can be 0, 1, 2, 3, or 4:

  • 0: Disable Remote Control

  • 1: Remote Control Enabled, User's Permission Required, Interact

  • 2: Remote Control Enabled, User's Permission Not Required, Interact

  • 3: Remote Control Enabled, User's Permission Required, View only

  • 4: Remote Control Enabled, User's Permission Not Required, View only

Sessions

MaxDisconnectionTime

Integer value specifying the number of minutes
 

MaxConnectionTime

Integer value specifying the number of minutes
 

MaxIdleTime

Integer value specifying the number of minutes
 

BrokenConnectionAction

The value can be 0 or 1:

  • 0: Disconnect

  • 1: End
 

ReconnectionAction

The value can be 0 or 1:

  • 0: Any

  • 1: Originating

Environment

TerminalServicesInitialProgram

Path to the executable file (string value)
 

TerminalServicesWorkDirectory

Path to the working directory (string value)
 

ConnectClientDrivesAtLogon

The value can be 0 or 1:

  • 0: Disabled

  • 1: Enabled
 

ConnectClientPrintersAtLogon

The value can be 0 or 1:

  • 0: Disabled

  • 1: Enabled
 

DefaultToMainPrinter

The value can be 0 or 1:

  • 0: Disabled

  • 1: Enabled