analyze Command (VSSConverter)

Use the analyze command of the VSSConverter command-line utility to analyze Visual SourceSafe databases.

Required Permissions

To use the VSSConverter tool, you must be a member of the Service Accounts security group. For more information, see Team Foundation Server Permissions. Also, you must be a member of the Database Administrators group for the Visual SourceSafe database. For more information, see Managing Your Team Using Visual SourceSafe at the Microsoft Web site (https://go.microsoft.com/fwlink/?LinkId=99102).

VSSConverter analyze settings_file

Parameters

Parameter

Description

settings_file

XML file specifying analysis or migration settings.

Remarks

The VSSConverter.exe is located in <drive>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE and is also available through the Visual Studio 2008 Command Prompt.

Before running the Visual SourceSafe (VSS) converter, you must do the following:

The default file name of the analysis report is VSSAnalysisReport.xml. This file is created in the same directory in which the converter is run.

If you specify an output file that already exists, the converter exits with the following error message:

Error: Output file VSSMigration.xml already exists

During analysis, if you do not provide a user mapping file, the converter creates a file with the name UserMap.xml in the current directory.

Limitations

You can only run one instance of the VSS Converter on a computer.

Example

In this example, the analyze command performs an analysis on the Visual SourceSafe database using the configuration in the settings.xml file.

>VSSConverter analyze settings.xml 

See Also

Tasks

Walkthrough: Preparing to Migrate from Visual SourceSafe to Team Foundation

Walkthrough: Migrating from Visual SourceSafe to Team Foundation

How to: Create a Settings File for Source Control Analysis and Migration

How to: Create a Settings File for Source Control Analysis and Migration

How to: Create a Team Project

How to: Add a Project or Solution to Version Control