Localversions 命令(Team Foundation 版本控制)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Team Foundation 版本控制 (TFVC) localversions 命令显示工作区中一个或多个项的版本。

先决条件

若要使用 localversions 命令,必须具有工作区的“使用”权限。 有关详细信息,请参阅默认 TFVC 权限

语法

tf localversions ItemSpec
[/recursive] [/format:brief|detailed]
[/workspace:WorkspaceName[;WorkspaceOwner]] [/collection:TeamProjectCollectionUrl]

参数

参数

Argument

说明

<itemspec>

指定要显示其版本号的文件或包含文件的文件夹。

只能指定本地文件或文件夹。 例如,c:\project1\binder.cs 有效,但 $/project1/binder.cs 无效。

注意

可指定多个 itemspec 参数。

<workspacename>

将此参数与 /workspace 选项一起使用,以指定映射到当前目录的工作区以外的工作区。

<workspaceowner>

如果要指定公共工作区,请将此参数与 workspacename 参数一起使用。

<TeamProjectCollectionUrl>

包含要显示其版本的一个或多个项的项目集合的 URL,例如 http://myserver:8080/tfs/DefaultCollection

选项

选项

说明

/format

指定以下选项之一来控制此命令返回的数据的显示方式:

  • Brief(默认):每个目录只显示一次,后跟其包含的文件。
  • Detailed:每个文件都显示在其完整路径之后。

/recursive

如果希望操作在子文件夹中包含项,请指定此选项。

/workspace

指定此选项可显示有关工作区中项版本的数据,而不是映射到当前目录的项版本。

/collection

指定项目集合。

注解

获取或签出文件时,通常会下载最新版本。 但是,工作区中可能有某些文件的较旧版本。

例如,你可能已签出某些文件,但几周没有签入工作。 在此期间,团队中的其他人可能已签入了对相同文件的更改。 在这种情况下,工作区中这些文件的版本会早于 TFVC 服务器上的当前版本。 可以使用 localversions 命令获取相关信息了解工作区中这些文件的版本。

其他 TFVC 命令提供有关 TFVC 服务器中的项以及映射到服务器的工作区的详细信息。 有关如何使用 tf 命令行实用工具的详细信息,请参阅使用 Team Foundation 版本控制命令

示例

以下示例显示映射到 c:\workspaces\FeatureA\catalog\controller 文件夹的工作区中 ControllerBase.cs 文件的版本。

c:\workspaces\FeatureA\catalog\controller>tf localversions ControllerBase.cs

以下示例显示映射到c:\workspaces\FeatureA\catalog 文件夹的工作区中所有文件(包括子文件夹中的文件)的版本。 由于指定了 /format:detailed 选项,因此每个文件都会显示其完整路径。

c:\workspaces\FeatureA\catalog\>tf localversions . /recursive /format:detailed