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

Article translations Article translations
Article ID: 317592 - View products that this article applies to.
This article was previously published under Q317592
Expand all | Collapse all

On This Page

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

Overview of the Lsreport.exe Tool

Lsreport.exe uses the following syntax:
lsreport /f [ path]filename /d start[ end] /t serverlist
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

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:
240444 Useful Terminal Services Resource Kit Utilities
For additional information about Terminal Services Licensing Technology, click the article number below to view the article in the Microsoft Knowledge Base:
275052 Terminal Services Licensing Technology for Application Service Providers
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:
http://www.microsoft.com/technet/prodtechnol/win2kts/evaluate/featfunc/tslicens.mspx

Properties

Article ID: 317592 - Last Review: October 31, 2006 - Revision: 4.1
APPLIES TO
  • Microsoft Windows 2000 Server
  • Microsoft Windows 2000 Advanced Server
  • Microsoft Windows 2000 Datacenter Server
Keywords: 
kbhowtomaster KB317592

Give Feedback

 

Contact us for more help

Contact us for more help
Connect with Answer Desk for expert help.
Get more support from smallbusiness.support.microsoft.com