Microsoft KB Archive/317592

= HOW TO: Use the Terminal Services Licensing Reporter Tool (Lsreport.exe) =

Article ID: 317592

Article Last Modified on 10/31/2006

-

APPLIES TO


 * Microsoft Windows 2000 Server
 * Microsoft Windows 2000 Advanced Server
 * Microsoft Windows 2000 Datacenter Server

-



This article was previously published under Q317592





IN THIS TASK

 * SUMMARY
 * Overview of the Lsreport.exe Tool
 * Examples
 * REFERENCES



SUMMARY
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:

'''Server

License ID

Keypack ID

Client

User

Start

End

Issue Type

License Type'''

back to the top

Overview of the Lsreport.exe Tool
Lsreport.exe uses the following syntax:

lsreport /f [ ]   /d  [  ] /t

The parameters that you can use with Lsreport.exe are:
 * /f [ ] : 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 [   ]: 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.
 *  : 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.

back to the top

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