列出工作项字段并查看指派给这些字段的特性

项目
08/12/2011

通过使用 witadmin listfields 命令行工具，可以生成在团队项目集合中定义的所有工作项字段的列表。使用此列表有助于了解已定义的字段类型，还可以选择将其中的一个字段用于新工作项类型中或添加到现有工作项类型中。而且，您还可以列出为特定字段定义的特性赋值，并确定哪些团队项目在使用哪些字段。

主题内容

查看工作项字段的特性
列出团队项目集合中的所有字段
列出团队项目集合中所有未使用的字段

所需权限

对于定义了工作项类型字段的团队项目集合，您必须是**“Readers (访问者)”组的成员，或者您的“查看此节点中的工作项”权限必须设置为“允许”**。

查看工作项字段的特性

列出团队项目集合中的所有字段

打开命令提示符窗口。
键入以下命令然后按 Enter，从而更改到包含要列出的工作项类型的目录。

cd ..驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\
在命令提示符下键入以下命令并按 Enter，从而列出工作项字段。
```
witadmin listfields /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /n:FieldName
```
将显示指定字段及其特性信息，如下例所示。
```
Field: Microsoft.VSTS.Common.Issue
Name: Issue
Type: String
Reportable As: dimension
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)
Indexed: False
```
**“Use”**参数指示使用字段的每个项目的名称以及工作项类型。有关字段特性的更多信息，请参见使用系统字段和 MSF 过程模板定义的字段。

列出团队项目集合中的所有字段

打开命令提示符窗口。
键入以下命令然后按 Enter，从而更改到包含要列出的工作项类型的目录。

cd ..驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE\
在命令提示符下键入以下命令并按 Enter，从而列出字段。
```
witadmin listfields /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName 
```
将显示指定项目集合的所有字段的字段信息。

列出未使用的字段

列出未由任何工作项类型使用的字段

打开命令提示符窗口。
键入以下命令然后按 Enter，从而更改到包含要列出的工作项类型的目录。

cd ..驱动器:\Program Files\Microsoft Visual Studio 10.0\Common7\IDE

在命令提示符下键入下面的命令并按 Enter，从而列出不再由任何工作项类型使用的字段。

witadmin listfields /collection:http://ServerName:Port/VirtualDirectoryName/CollectionName /unused

对于每个未使用的字段，会显示字段和特性信息，如下例所示。

Field: Microsoft.VSTS.CMMI.TaskType
Name: Task Type
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Flag
Name: Flag
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False

Field: Microsoft.VSTSUE.Common.Progress
Name: Progress
Type: String
Reportable As: dimension
Use: Not In Use
Indexed: False