Status 命令

Visual Studio Team System

Status 命令

显示有关一个或多个工作区中项的挂起的更改的信息。

tf status itemspec [/server:servername] ([/workspace:workspacename[;workspaceowner]]
 | [/shelveset:shelvesetname[;shelvesetowner]]) [/format:(brief|detailed)] 
[/recursive] [/user:(*|username)]

参数

参数	说明
itemspec	标识要显示其状态详细信息的文件或文件夹。有关 Team Foundation 如何通过分析 itemspecs 确定范围内项的更多信息，请参见命令行语法。
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 命令，有关指向这些命令的链接，请参见信息性命令。

命令输出

如果更改类型为 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

安全性

若要使用 status 命令，您必须将对所有指定文件或文件夹的“读”权限设置为“允许”。有关更多信息，请参见 Team Foundation Server 权限。

请参见

参数

命令输出

参考

概念

其他资源