Share via


Command-Line Tool for the Best Practices Analyzer Tool

You can perform the same scans at a command prompt that you can by using the graphical user interface (GUI) version of the Best Practices Analyzer tool for Team Foundation Server. For example, you might scan your deployment at set intervals by running the command-line tool as part of an automated script. In some cases, a product-support technician might instruct you to run the command-line tool to help you solve a problem.

The command-line tool collects and analyzes data. As it collects data, the tool performs the following functions:

During analysis, the tool processes the data that it collects based on the test rules. For more information, see Rule Checking Performed by the Best Practices Analyzer Tool.

After you install the GUI version, you can locate the command-line tool TfsBpaCmd.exe in Drive:/Program Files/Microsoft Team Foundation Server 2010 Best Practices Analyzer.

Required Permissions

To use the TfsBpaCmd.exe command, you must be a member of the Team Foundation Administrators security group on the application-tier server for Team Foundation and a member of the sysadmin security group on the computers that are being scanned. For more information, see Prerequisites for Using the Best Practices Analyzer Tool.

Note

Even if you are logged on with administrative credentials, you must open an elevated Command Prompt to perform this function on a server that is running Windows Server 2008. To open an elevated Command Prompt, click Start, right-click Command Prompt, and click Run as administrator. For more information, see the Microsoft Web site.

TfsBpaCmd.exe –GS TFSServerURL http://ServerName:Port/VirtualDirectoryName [options]

Parameters

Option

Description

-cfg File

Optional. Specifies the configuration XML file that determines the rules to check as the tool collects data. By default, the tool uses TfsBpa.Config.xml, which is located in Drive:/Program Files/Microsoft Team Foundation Server 2010 Best Practices Analyzer/en.

For this option, specify TfsBpa.Config.xml, which runs the rules in the following files:

  • Tfs.MachineHealthCheck.Config.xml: Specifies rules that check the system environment for each server in the deployment of Team Foundation.

  • Tfs.ASHealthCheck.Config.xml: Specifies rules that check the server that hosts SQL Server Analysis Services.

  • Tfs.ATHealthCheck.Config.xml: Specifies rules that check the application-tier environment and configuration. This file also runs the rules in the Tfs.BuildHealthCheck and Tfs.LabHealthCheck files.

  • Tfs.BuildHealthCheck.Config.xml: Specifies rules that check the server that hosts Team Foundation Build Service and the build configuration.

  • Tfs.DTHealthCheck.Config.xml: Specifies rules that check the server that hosts databases on which Team Foundation relies.

  • Tfs.LabHealthCheck: Specifies rules that check the server that hosts Visual Studio Lab Management and its configuration.

  • Tfs.RSHealthCheck.Config.xml: Specifies rules that check the server that hosts SQL Server Reporting Services.

  • Tfs.Statistics.Config.xml: Specifies rules that collect usage information for the team project collections in the deployment.

  • Tfs.WSSHealthCheck.Config.xml: Specifies rules that check the server that hosts SharePoint Products for the deployment of Team Foundation.

-dat File

Optional. Specifies the data XML file into which the tool should write the data that it collects. If you specify the name of a file that is not in the current directory, the tool uses the name that you specified for the output file. If you specify the name of an existing file and the analyze (-a) option, the tool performs the following tasks:

  • Reads the data in the file.

  • Analyzes the data.

  • Overwrites the file with the output of the analysis.

By default, the tool writes the data into TfsBpaCmd.DateTimeStamp.data.xml, in a folder that is named tfsbpaDateTimeStamp.

  • For Windows XP Home Edition, Windows XP Professional, Windows Server 2003, the tool writes to files in Drive:\Documents and Settings\UserName\Application Data\Microsoft\TfsBPA 

  • For Windows Vista and Windows Server 2008, the tool writes to files in Drive:\Users\UserName\AppData\Roaming\Microsoft\TfsBPA

-in File

Optional. Specifies that the tool should load the data in File before scanning the computers. You can either use this option to collect data from additional categories in the same file or to reanalyze previous data. If you specify File as "$", the tool uses the file that is named output.Label.DateTimeStamp.xml and that has the most recent date-time stamp.

-l Label

Optional. Specifies a label for the scan. If you do not specify a label, the tool uses the date and time of the scan as the label.

The tool uses the label of the scan to name the output file and folder. Also, you use the label to identify the scan in a list when you open the GUI. The value of the output file name is TfsBpaCmd.Label.DateTimeStamp.data.xml. The tool writes output files into a folder that is named tfsbpa.Label.DateTimeStamp.

-GS Name Value

Required. Specifies to scan the application-tier server for Team Foundation based on its URL and the value of that URL.

  • Name: TFSServerURL

  • Value: http://ServerName:Port/VirtualDirectoryName

For example, use the following syntax:

TFSServerURL http://myserver:8080/tfs

-r Parameter

Optional. Specifies the type of scan that the tool should run from the following options:

  • HealthCheck (default option that corresponds to the Team Foundation Server Complete Health Check)

  • FrameworkHealthCheck

  • WarehouseHealthCheck

  • BuildHealthCheck

  • LabManagementHealthCheck

  • SharePointHealthCheck

  • Statistics

You can specify only one type of scan to run. For more information, see Rule Checking Performed by the Best Practices Analyzer Tool.

-th NumberOfThreads

Optional. Specifies the maximum number of threads to run at the same time. By default, the value of this option is 50.

-to Time

Optional. Specifies the default time (in seconds) that the tool will wait to collect data from a server that you specify. By default, the value of this option is 300.

-c

Optional. Specifies that the tool should collect but not analyze data from the servers that you specify. By default, the tool obeys this option if you do not specify either the collect (-c) or the analyze (-a) option.

-a

Optional. Specifies that the tool should analyze the data XML file that it generated in a previous operation. You can use this option to analyze an existing output file. You can also use this option to collect and analyze data for a new scan, either by specifying a data XML file that is not in the current directory or by not specifying a data XML file.

-e

Optional. Specifies that the tool should not record in the output file any values that are marked NotForExport in the configuration XML files.

-s

Optional. Specifies that the tool should run the scan by using the parameters that the GUI version stored in the registry.

-?

Optional. Specifies that help information for the tool should appear.

Examples

You can use the following command to scan the named server, running the rules for a Team Foundation Server Complete Health Check.

TfsBpaCmd.exe –GS TFSServerURL http://machinename:8080/tfs

You can use the following command to run only those rules in the SharePoint Products Health Check.

TfsBpaCmd.exe –GS TFSServerURL http://machinename:8080/tfs –r SharePointHealthCheck

See Also

Concepts

Rule Checking Performed by the Best Practices Analyzer Tool

Other Resources

Using the Best Practices Analyzer Tool