用于源代码管理迁移的 VSSConverter 命令行实用工具

更新：2007 年 11 月

使用 VSSConverter 命令行实用工具可分析 Visual SourceSafe 数据库，然后将这些数据库迁移到 Team Foundation 版本控制。

VSSConverter.exe 位于 <驱动器>:\Program Files\Microsoft Visual Studio 9.0\Common7\IDE 中，也可以从 Visual Studio 命令提示符获得。

重要说明：
VSS Converter 需要 Microsoft Visual SourceSafe 2005 或更高版本。

所有 VSSConverter 命令都可使用以下全局选项。

选项	说明
/?, /h, /help	显示帮助。

迁移后保留哪些信息

从 Visual SourceSafe 迁移到 Team Foundation 版本控制时，将保留以下历史信息：

添加文件或文件夹 保存文件或文件夹名称、添加的日期和时间及用户名。
删除文件或文件夹 保存文件或文件夹名称、删除的日期和时间及用户名。
撤销删除文件或文件夹 保存文件或文件夹名称、撤销删除的日期和时间及用户名。
重命名文件或文件夹 保存旧文件或文件夹名称、新名称、重命名的日期和时间及用户名。
编辑文件 保存签入的日期和时间及用户名。
修改标签 保存标签名、修改的日期和时间及用户名。
移动文件夹 保存旧位置、新位置、移动的日期和时间及用户名。

说明：

如果源文件夹和目标文件夹同时迁移，则有关 Visual SourceSafe 数据库中文件夹移动的信息只保留在 Team Foundation 版本控制中。

说明：
如果源文件夹和目标文件夹同时迁移，则有关 Visual SourceSafe 数据库中文件夹移动的信息只保留在 Team Foundation 版本控制中。

转换器工具不保留有关下列 Visual SourceSafe 操作的历史记录信息：

共享 Team Foundation 版本控制中不支持共享。通过在开始共享时将共享的 Visual SourceSafe 文件的版本复制到目标文件夹来将这些文件迁移到 Team Foundation 版本控制。此后，对共享文件的更改将复制到两份副本中。
分支由于共享是进行分支的前提条件，因此对共享文件进行迁移会导致将该文件复制到目标文件夹。进行分支后，对任一分支的更改都将迁移到 Team Foundation 版本控制中相应的副本。
固定 Team Foundation 版本控制不支持固定。所有固定的文件都可通过创建两个标签来迁移。PINNED_LATEST 标签适用于已固定文件的固定的版本及取消固定的文件的最新版本。PINNED 标签仅适用于已固定文件的固定的版本。迁移后，PINNED_LATEST 标签检索的文件与在 Visual SourceSafe 中执行 Get Latest 操作所获得的文件相同。但是，如果在固定文件后发生了签入以外的事件（例如重命名或删除操作），则 PINNED_LATEST 标签可能会返回不同的文件。
对文件夹进行移动与还原组合操作 对版本历史记录中包含移动操作和还原操作的文件夹的迁移操作可能无法正常进行。

迁移期间不会保留与操作关联的时间戳，因为它将被转换时的时间戳替代。用户操作的原始时间戳将追加到注释中，如下例所示。

迁移前的 Visual SourceSafe

2005 年 5 月 2 日下午 3:30 迁移后的 Team Foundation 版本控制

用户操作：$/ProjectA/a.c checkin

版本：5

时间戳：June 3, 2002 12.30pm

注释：已修复“欢迎”屏幕中的 Bug

用户操作：$/ProjectA/a.c checkin

版本：5

时间戳：June 3, 2002 12.30pm

注释：{06/03/2002 12.30 PM}

已修复“欢迎”屏幕中的 Bug

VSS 转换器不会迁移源代码管理绑定。迁移之后，必须更改所有 Visual Studio 解决方案的源代码管理绑定，以使它们绑定到 Team Foundation 版本控制。有关如何迁移源代码管理绑定的更多信息，请参见如何：从 Visual SourceSafe 中迁移源代码管理绑定