This step-by-step article describes how to use the Terminal Services Licensing Reporter tool (Lsreport.exe) to display and analyze the license information that is contained in the database of Terminal Services license servers.

Lsreport.exe is available in the Microsoft Windows 2000 Server Resource Kit. Lsreport.exe is a command-line utility that you can use to display information about the licenses that are issued by Terminal Services license servers. Lsreport.exe connects to Terminal Services license servers and logs information about the license key packs that are installed on the servers.

Lsreport.exe exports the contents of the license server database to a text file. By default, the file name is Lsreport.txt, and it is created in the current working folder. The resulting output is tab-delimited, and contains the following columns:

Overview of the Lsreport.exe Tool

Lsreport.exe uses the following syntax: The parameters that you can use with Lsreport.exe are:

•	/f [path]filename: Use this parameter to specify a file name (and optional path) for the log file. If an output file with the same name already exists, it is overwritten. If you omit this parameter, Lsreport.exe uses the default log file name, Lsreport.txt, and creates it in the current working folder.
•	/d start[ end ]: Use this parameter to write only licenses that are in effect between the start and end dates to the output file. If you do not specify an end date, the current date is used by default. An in-effect license is a license that is valid at any point over the specified period of time. Active licenses are valid at all points after issue, and temporary licenses are valid for 90 days after issue.
•	/t: Use this parameter to only write information about temporary licenses to the output file. By default, Lsreport.exe writes information about all licenses to the output file.
•	serverlist: Use this parameter to list all Terminal Services license servers that you want to query. Use a space to separate each item. If you omit this parameter, Lsreport.exe obtains a list from the domain controller, and then queries all discoverable domain and enterprise Terminal Services license servers.

Examples

•	To write information about all licenses to the Lsreport.txt file in the current working folder, type the following line at the command prompt, and then press ENTER: lsreport
•	To write information about all licenses to the Output.txt file in the Reports folder on drive E, type the following line at the command prompt, and then press ENTER: lsreport /f e:\reports\output.txt
•	To list all temporary licenses on Terminal Services license servers that are named TS1 and TS2 in the Licenses.txt file in the root folder of drive C, type the following line at the command prompt, and then press ENTER: lsreport /f c:\licenses.txt /t ts1 ts2

Back to the top

REFERENCES

For more information about Lsreport.exe, type lsreport /? at the command prompt, and then press ENTER.

For additional information about Lsreport.exe and other Terminal Services Resource Kit tools, click the article number below to view the article in the Microsoft Knowledge Base: For additional information about Terminal Services Licensing Technology, click the article number below to view the article in the Microsoft Knowledge Base: For more information about Terminal Services Licensing technology and deployment requirements, see the Microsoft Windows 2000 Terminal Services Licensing Technology White Paper (Tslicensing.doc) that is available at the following Microsoft Web site:

Back to the top