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.
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:
- 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:
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:
back to the top