Status 命令
更新：2007 年 11 月
显示有关一个或多个工作区中项的挂起的更改的信息。
必需的权限
若要使用 status 命令，您必须将对所有指定文件或文件夹的“读”权限设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。
tf status itemspec [/server:servername] [/workspace:workspacename[;workspaceowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
tf status itemspec [/server:servername] [/shelveset:shelvesetname[;shelvesetowner]] [/format:(brief|detailed)]
[/recursive] [/user:(*|username)]
参数
参数 |
说明 |
|---|---|
itemspec |
标识要显示其状态详细信息的文件或文件夹。有关 Team Foundation 如何通过分析 itemspecs 确定范围内项的更多信息，请参见命令行语法 (Team System)。 |
servername |
用户提供的 /server 选项的值。示例：http://teamfoundation2:8080。 |
workspacename |
用户提供的 /workspace 选项的值。 |
workspaceowner |
指定创建工作区的用户的名称。 |
shelvesetname |
用户提供的 /shelveset 选项的值。 |
shelvesetowner |
指定搁置集所有者的名称。 |
username |
向 /user 选项提供值。根据网络设置，username 值可以用两种方式之一来表示：DOMAIN\username 或 username。 |
选项 |
说明 |
|---|---|
/server |
标识 Team Foundation Server。如果从未映射到工作区的目录调用命令，则此选项是必需的。 |
/workspace |
指定要查看其更改列表的工作区的名称。如果未指定此选项，而您正在从已添加到工作区的目录运行该命令，则使用当前工作区。 此选项不能与 /shelveset 选项一起使用。 |
/shelveset |
要查看其更改列表的搁置集的名称。 此选项不能与 /workspace 选项一起使用。 |
/format |
状态信息的格式。Brief 显示更改列表以及已经对它们做出的、使签入挂起的更改。Detailed 显示完整状态信息。Brief 为默认值。 |
/recursive |
显示特定目录和任何子目录中所有项的状态信息。 |
/user |
筛选对指定用户的更改列表。星号 (*) 可以用来表示所有用户。默认为当前用户。 |
备注
可以使用 status 命令显示挂起更改的列表。挂起的更改是尚未提交到服务器并捆绑到一个受版本管理的变更集中的、对文件或文件夹的修订。 有关更多信息，请参见 挂起的更改。
还可以指定 /shelveset 选项，以显示搁置集所包含的搁置的、未受版本管理的变更集的详细信息。有关挂起的更改和搁置的更改之间的差异的更多信息，请参见 使用版本控制搁置集。
还有其他一些命令可提供有关服务器和所有映射到服务器的工作区上的项的附加信息的 Team Foundation 命令，有关指向这些命令的链接，请参见 信息性命令。
有关如何查找 tf 命令行实用工具的更多信息，请参见 Tf 命令行实用工具命令。
命令输出
如果挂起的更改类型为 rename，则显示新名称。有关更多信息，请参见 Rename 命令（Team Foundation 版本控制）。
有两种显示模式：简要 (brief) 和详细 (detailed)。
/Format:brief 显示项的文件名、变更和本地路径、项是否被锁定、项所表示的挂起更改的类型、做出更改的用户以及项的工作区版本在磁盘上的位置。输出先按文件夹排序，然后按文件夹中的文件名排序。
/Format:detailed 在输出中显示有关每个挂起的更改的多行信息。详细输出包含简要输出的所有内容，并增加了日期、时间和其他信息。
示例
下面的示例显示有关当前工作区中当前用户的所有挂起的更改的信息。当前工作区是本地目录映射到的工作区。
c:\projects>tf status
下面的示例显示当前计算机上 d:\src 下当前用户的所有挂起的更改。
c:\projects>tf status/recursive d:\src
下面的示例显示 Beta1 工作区中当前用户的所有挂起的更改。
c:\projects>tf status/workspace:Beta1
下面的示例显示用户 Jason 的所有挂起的更改的状态信息。
c:\projects>tf status/user:Jason
下面的示例显示服务器上所有工作区中所有用户的所有挂起的更改的状态信息。
c:\projects>tf status/user:*
下面的示例显示有关位于 teamserver2 的服务器上所有工作区中当前用户的所有挂起的更改的信息。
c:\projects>tf status/server:teamserver2 /workspace:*
下面的示例显示有关所有映射到 teamserver2 服务器的工作区中由 Joe 做出的但还未签入的所有更改的信息。
c:\projects>tf status/server:teamserver2 /workspace:* /user:joe