Status 命令（Team Foundation 版本控制）

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

Visual Studio 2019 | Visual Studio 2022

Team Foundation 版本控制 (TFVC) status 命令或其别名 stat 显示有关文件和文件夹的挂起的更改，以及一个或多个工作区中的挂起的更改备选项的信息。 当你使用 /shelveset 选项时，命令将显示有关搁置集中挂起的更改的信息。

注意

挂起的更改备选项是工作区文件夹或子文件夹中未添加到版本控制的文件。 要在 Visual Studio 中查看所有挂起的更改备选项，请转到“团队资源管理器”>“挂起的更改”>“排除的更改”，然后选择“已检测”。

先决条件

要使用 status 命令，你必须将源项的“读取”权限以及目标文件夹的“签出”和“合并”权限设置为“允许”。 有关详细信息，请参阅默认 TFVC 权限。

语法

tf stat[us] itemspec [/collection:TeamProjectCollectionUrl]
[/login:username,[password]]
([/workspace:workspacename[;workspaceowner]] 
| [/shelveset:shelvesetname[;shelvesetowner]])
[/format:(brief|detailed)] [/recursive][/user:(*|username)]
[/nodetect]

参数

参数

Argument

说明

/collection: <TeamProjectCollectionUrl>

当你使用 /workspace 选项时，请指定包含工作区（其中包含挂起的更改）的项目集合的 URL。 例如：http://myserver:8080/tfs/DefaultCollection。

默认情况下，将假定项目集合为包含映射当前目录的工作区的集合（如果未指定）。

如果你不使用 /workspace 选项，请忽略。

注意

有关此选项的限制，请参阅注解。

/format

指定每个挂起的更改的显示详细程度：

• Brief（默认值）：如果使用的是 /collection 和 /workspace 选项，则显示有关每个挂起的更改的一个行，其中包括：文件名、更改、项是否已锁定（用星号 * 指示）、本地路径和用户。 某些数据可能会被截断。
• Detailed：显示每个挂起的更改的完整说明。 除了上述信息外，此选项还会显示更多数据（如日期和时间）。

<itemspec>

指定要为其挂起更改数据的项。 有关语法，请参阅使用 Team Foundation 版本控制命令。 你可以指定多个 itemspec 参数。

/login

指定要用于运行该命令的用户帐户。 请参阅使用 Team Foundation 版本控制命令。

/recursive

以递归方式检索有关指定目录和任何子目录中的项的挂起更改的数据。

/shelveset:<shelvesetname>[;<shelvesetowner>]

指定包含要列出的更改的搁置集。

此选项不能与 /workspace 选项结合使用。

/user

列出由指定用户做出的所有挂起的更改。 星号 * 包括有关所有用户的更改的数据。 默认为当前用户。

此选项的可接受值：

• <username>
• <useraccount>
• 星号 *

注意

有关此选项的限制，请参阅注解。

/workspace:<workspacename>[;<workspaceowner>]

指定包含挂起的更改的工作区的名称。 如果未指定，则工作区将是映射当前目录的工作区。

你可以指定 workspaceowner，以获取有关属于特定用户的工作区中的挂起的更改的数据。 假定工作区为当前用户（如果未指定）或 /login:<username>（如果已指定）。

此选项不能与 /shelveset 选项结合使用。

注意

有关此选项的限制，请参阅注解。

注解

你可以使用 status 命令来查看当前工作区（例如映射当前目录的工作区）中的挂起的更改，而无论它是本地工作区还是服务器工作区。 你还可以利用 /collection、/user 和 /workspace 选项，使用此命令来查看远程服务器工作区中的挂起的更改，例如另一个用户在其他开发计算机上所做的更改。 但是，你无法查看远程本地工作区中的挂起的更改。

有关详细信息，请参阅决定使用本地工作区还是服务器工作区。

示例

在以下所有示例中，假设 $/SiteApp/Main/ 映射到工作区中的 c:\code\SiteApp\Main\。

列出当前工作区中的所有更改

以下示例列出了工作区中的所有挂起的更改：

c:\code\SiteApp\Main\SolutionA\>tf stat

列出文件夹中的所有更改

以下示例列出了所有对 SolutionA 文件夹中所有项所做的挂起的更改：

c:\code\SiteApp\Main>tf stat SolutionA\*

列出文件夹及其子文件夹中的所有更改

以下示例列出了对 SolutionA 文件夹中所有项（包括其子文件夹中的更改）所做的挂起的更改：

c:\code\SiteApp\Main>tf stat SolutionA\* /recursive

后续步骤

• 您在版本控制下对文件所做的大多数更改都将在工作区中作为挂起的更改进行排队。 有关详细信息，请参阅开发代码和管理挂起的更改和创建和使用工作区。

• 你可以使用 Difference 命令来获取有关编辑更改或文件内容更改的详细信息。

• 如果你需要搁置更改，并且可能还想为其他任务清理工作区，请使用 Shelve 命令。 有关搁置集的详细信息，请参阅暂停工作并管理搁置集。

• 当你准备好签入对服务器所做的更改时，请使用 Checkin 命令。

• 有关如何使用 tf 实用工具的详细信息，请参阅使用 Team Foundation 版本控制命令