Displaying Terminal Server/Citrix User Properties

Important Note: Hyena’s Terminal Server integration features are only available in the Enterprise Edition of Hyena. Hyena’s Standard Edition will allow terminal server user settings to be viewed or modified only for the first 30 days after installation. This allows the functionality of the Terminal Server features to be fully evaluated before any additional licenses for it are purchased.  For more information on the licensing of the Enterprise Edition, see the Licensing and How to Order section.

References to "Terminal Server" in this document also apply to Citrix installations as well.

Setting up Hyena to Access Terminal Server User Properties and Sessions

Microsoft has added the interfaces for accessing terminal server user settings through a .DLL named “wtsapi32.dll”.  This file is part of service pack 4 for Windows Terminal Server.  It is highly recommended that any computer with user account information to be updated using this interface be upgraded to service pack 4 or later.

There are two methods to use Hyena to modify Terminal Server user information:

Install Hyena onto the terminal server itself, and connect to it through your workstation through a terminal server client connection.  If your terminal server has sp4 installed, you should be able to see the "Terminal" tab on the user properties dialog.

 - or -

Copy the following files into Hyena's installation or your workstation's system (System32) directory, which can be found in the system32 directory of a Terminal Server:

wtsapi32.dll

utildll.dll

winsta.dll

regapi.dll

Microsoft does not allow third party software developers to re-distribute these files.  You will only find the wtsapi32.dll file if the Terminal Server is using service pack 4 or later.

Note that the icon used in Hyena for terminal server computers has been modified for easier identification of these servers.

Check to make sure that Hyena's installation directory is the working directory when you are using Hyena, and restart Hyena if necessary.  You will then be able to modify any user's terminal server settings, by simply displaying the user Properties dialog, and selecting the "Terminal" tab.

Accessing User Terminal Server Properties

The terminal server options for a user are accessed through the User Properties dialog by going to the "Terminal" tab, as show in the image below.

The terminal dialog provides for full access to profile, home directory, and session settings.  Hyena's Home Directory Management features are available for terminal server home directories.

Active Directory Integration

Terminal Server (TSE) user settings are not stored in individual attributes in Active Directory, but instead are stored in one attribute that does not permit direct viewing of its contents.  Hyena allows the user TSE fields, however, to be included into Hyena's Active Directory queries.  

To include one or more TSE fields into an Active Directory query, access the File->Manage Object View->Queries dialog, and either create a new Users query or modify an existing query that displays user-related information.  To add the TSE attributes, select Terminal Server Attributes from the Attribute Category.

TSE information is extremely slow to retrieve, therefore it is recommended that a special query be created to display only the minimal information required.  Do NOT add TSE fields to a default query for any view or Hyena's overall performance will be severely affected.

Viewing Terminal Server Sessions

Hyena can display all terminal server sessions as well as associated processes, through the Sessions object for any server.  For more information on this topic and support functions on remote sessions, see the Terminal Server Sessions topic.