Function
Sets the Terminal Services settings for a new or existing user account. The account either exists in a Active Directory or NT4 domain.
Deployment
This action is typically used in a script that is intended to:
create new users in Active Directory or NT4 domains and to setup the Terminal Services settings for each individual
account or
to setup the Terminal Services for a number of existing user accounts.
For new user accounts, the action that creates the user account should precede this action. For new user accounts in Active Directory, it is strongly recommended to create the user account using server binding, e.g. specify the domain controller both in this action and the action that creates the user account in Active Directory.
Properties
Property Name Description Typical setting Remarks
User account The name of user account for which the Terminal Services settings must be applied. The user account must be specified using the first part of the user logon name
([email protected] -> j.smith) in Active Directory or the SAM account name (username) in Windows NT4 networks.
%Username%
Domain Controller The name of the domain controller that maintains the user account (DNS or NETBIOS style, e.g. server_1.tools4ever.com or SERVER_1). In case the user account is just created and multiple domain controllers exist, this property should equal the domain controller used to create the account. If this value is specified, the 'Domain' property is ignored.
%DomainController% If the Domain Controller property is specified and the user account is created in Active Directory in the same script, you must specify the same domain controller in the action that creates the user account in Active Directory.
59
Domain The name of the domain (DNS or
NETBIOS style, e.g. tools4ever.com or TOOLS4EVER) of the user account. If this property is specified and the 'Domain Controller' property is not specified, User Management Resource Administrator searches for an arbitrary domain controller of the domain. In case the user account is just created and multiple domain controller exist, this domain controller might not recognize the user as an existing user account. In this case it is advised to specify the property 'Domain Controller' instead. This property is ignored if a value is specified for the property 'Domain Controller'.
Profile path The Terminal Services Profile path. The profile is a roaming or
mandatory user profile for use when the user logs on to a Terminal server. To enable a roaming or mandatory profile, type the network path in this form: \\\\server
name\\profiles folder name\\user name. To assign a mandatory user profile, type the network path in this form: \\\\server name\\profiles folder name\\user profile name. The Terminal Services profile path is used for logging on to Terminal servers only. If you specify a profile path for logging on to
Windows 2000, the path is also used for logging on to Terminal servers unless you specify a Terminal Services profile path here.
60
Home directory The Terminal Services home directory. Each user on a Terminal server should have a unique home directory. This ensures that application information is stored separately for each user in the multiuser environment. You can specify a directory on the local server (example: C:\\Users\\%Username% - > C:\\Users\\johnw) or shared network directory (\\\\Server_A\\Users\\%Username% - > \\\\Server_A\\Users\\johnw). In the latter case, you also need to specify a value for the 'Home directory drive' property.
Home directory
drive The Terminal Services home directory drive. Specify the drive letter (example: J:) mapped to the shared network directory specified for property 'Home directory'. In case you specify a local home directory, you should not to specify this property.
Allow logon to
terminal server Specifies whether the user is permitted to log on to the Terminal server.
Yes
End disconnected
session (seconds) Sets the maximum time that a disconnected session remains active on the server. If you specify this property, a disconnected session is reset after the time in seconds elapses. The value is specified in seconds. Do not specify this
property if you don't want to reset a disconnected session on the server.
Active session limit
(seconds) Sets the maximum duration for sessions in seconds. If you specify a duration, the session is
disconnected or reset after the time elapses. Do not specify this property (or specify a value of 0 (zero)) to allow the connection to continue for an unlimited period.
61
Idle session limit
(seconds) Sets the maximum idle time in seconds allowed before the session is disconnected or reset. If you specify a duration, the session is disconnected or reset after there has been no client activity for that period of time. Do not specify this property (or specify a value of 0 (zero)) to allow clients to remain idle indefinitely.
Disconnect on connection broken - time-out
Disconnect the client when the connection to the server is broken for any reason, including a request, a connection error, or a session limit is reached. The client can reconnect to the session if needed. If you specify no, the session is reset. A reset session cannot be
reconnected.
Yes
Allow reconnection
from any client Specifies that Terminal Services allows reconnection to a disconnected session from any computer. This is the default setting. If you select 'No' a reconnection to a disconnected session is restricted to the computer that started the session. This option is supported only for Citrix ICA- based clients that provide a serial number when connecting."),
Yes
User can specify
initial program Specifies whether the user can start any program. If you specify 'No' the program specified at property 'Logon program' runs automatically when the user logs onto a remote computer. Terminal server logs the user off when the user exits that program.
Yes
Logon program The path and file name of the application that you want to start when the user logs on to the Terminal server.
Logon program
working directory The working directory path for the application that you want to start when the user logs on to the Terminal server.
62
Connect client
drives at logon This option is for ICA clients only. Specifies whether to automatically reconnect to mapped client drives.
Yes
Connect client
printers at logon Specifies whether to automatically reconnect to mapped client printers. Yes Default to main
client printer Specifies whether to automatically print to the client’s default printer. Yes Remote control Specify the level to control or
observe a user's session. If you do not specify value for this property, the remote control function is disabled.
Callback enabled Set this property to 'Yes' if you want to enable the Terminal Server callback function. By default, (or when you specify 'No'), this function is disabled.
Fixed callback
phone number Set this property to 'Yes' if you want the Terminal Server to callback at a default fixed phone number. You need to specify the number for property 'Callback phone number'.
Callback phone
number Specify the callback phone number. If you set this, value, you should also set the value of properties 'Callback enabled' and 'Fixed callback phone number' to 'Yes'.
63