-
destroywitd:销毁工作项类型和销毁永不恢复的该类型的每个工作项。
-
exportwitd:将工作项类型的定义导出到 XML 文件或命令提示符窗口。
-
importwitd:将工作项类型从 XML 定义文件导入运行 Team Foundation Server 的服务器上的团队项目。如果具有相同名称的工作项类型已经存在,则该新工作项类型会覆盖现有工作项类型。如果工作项类型尚不存在,则此命令将创建一个工作项类型。若要验证定义工作项类型的 XML,但不导入文件,可以使用 /v 选项。
-
listwitd:在命令提示符窗口中显示指定项目中的工作项类型的名称。
-
renamewitd:更改特定项目中的工作项类型的显示名称。运行此命令后,该类型的所有工作项将显示新名称。
在运行 团队资源管理器 的客户端计算机上,witadmin 命令行实用工具位于驱动器:/Program Files/Microsoft Visual Studio 10.0/Common7/IDE 中。
有关工作项类型的更多信息,请参见向过程模板添加工作项类型。
必需的权限
对于定义工作项类型处的团队项目,您必须具有以下权限集:
-
若要导出或列出工作项类型,您必须是“Readers (访问者)”组的成员,或者将“查看此节点中的工作项”权限设置为“允许”。
-
若要销毁、导入或重命名工作项类型,您必须是“Team Foundation Administrators (Team Foundation 管理员)”安全组或“Project Administrators (项目管理员)”安全组的成员。
有关更多信息,请参见 Team Foundation Server 权限 和Team Foundation Server 默认组、权限和角色。
说明 |
---|
即使您是以管理权限登录的,也必须使用提升的权限打开命令提示符窗口,才能在运行 Windows Server 2008 的服务器上执行此功能。若要使用提升的权限打开命令提示符窗口,请单击“开始”,右击“命令提示符”,然后单击“以管理员身份运行”。有关更多信息,请参见以下 Microsoft 网站:User Access Control(用户访问控制)。 |
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]
参数 | 说明 |
---|---|
/collection:CollectionURL | 指定团队项目集合的 URI。URI 的格式为:http://ServerName:Port/VirtualDirectoryName/CollectionName 如果未使用虚拟目录,则 URI 将为以下格式: http://ServerName:Port/CollectionName |
/p:项目 | 要为其管理工作项类型的团队项目。必须在 /s server 参数指定的项目集合中定义此团队项目。 除非运行 importwitd 命令和 /v 选项,否则 /p 参数是必需的。 |
/n:TypeName | 要销毁、导出、导入或重命名的工作项类型的名称。 |
/f:FileName | 包含要导出或导入的工作项类型的 XML 定义文件的路径和文件名称。如果省略此参数,则在使用 exportwitd 命令时,XML 将显示在命令提示符窗口中。
说明
如果您使用的是 Windows Vista,则可能无权访问某些文件夹。如果尝试将工作项类型导出到您没有权限的位置,注册表虚拟化技术将自动重定向导出的文件,并将其保存到虚拟存储区。若要避免此重定向操作,可以将该文件导出到您拥有权限的位置。 有关注册表虚拟化的更多信息,请参见 Microsoft 网站:Registry Virtualization(注册表虚拟化)和 Common file and registry virtualization issues in Windows Vista(Windows Vista 中常见的文件和注册表虚拟化问题)。
|
/e:编码 | .NET Framework 2.0 编码格式的名称。该命令使用指定的编码导出或导入 XML 数据。例如,/e:utf-7 指定 Unicode (UTF-7) 编码。如果省略此参数,则 witadmin 将尝试检测编码,并且如果检测失败,则 witadmin 将使用 UTF-8。 |
/exportgloballists | 导出工作项类型引用的全局列表的定义。全局列表的定义将嵌入到工作项类型定义 XML。如果未指定,则忽略全局列表的定义。 |
/v | 验证定义工作项类型的 XML,但不导入 XML 定义文件。
说明
可以验证类型定义,而不指定团队项目。忽略对项目范围组的引用。
|
/new:NewName | 工作项类型的新名称。 |
/noprompt | 禁用提示进行确认。 |
/?或help | 在“命令提示符”窗口中显示有关命令的帮助。 |
除非另外指定,否则下面的值适用于每个示例:
-
团队项目集合的 URI:http://AdventureWorksServer:8080/AWTeam/Collection1
-
项目名称:AdventureWorks
-
输入或输出文件的名称:myworkitems.xml
-
工作项类型名称:myworkitem
-
默认编码:UTF-8
导出工作项类型的定义
下面的命令将 myworkitem 的定义导出到文件 myworkitems.xml。
witadmin exportwitd /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myworkitems.xml /n:myworkitem
下面的示例用 Unicode (UTF-7) 编码导出工作项。
导出工作项类型和其引用的全局列表的定义
下面的示例导出工作项类型和其引用的全局列表。
列出工作项类型的定义。
下面的示例在“命令提示符”窗口中显示工作项类型的定义。
导入工作项类型的定义
下面的示例从 XML 文件导入工作项定义。