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:
Create a settings file that contains the following information:
The location of the Visual SourceSafe database.
The location and file name for an output report file (optional).
The location and file name for a user mapping file (optional).
For more information, see How to: Create a Settings File for Source Control Analysis and Migration.
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