Team Foundation 的命名限制

项目
02/22/2013

Visual Studio Team Foundation Server (TFS) 中许多组件的命名都具有特定的限制。这些限制有助于保证一致的用户体验，并提供与其他程序的兼容性。这些限制可包括长度、特殊字符、唯一性或其他特性。

本主题包含以下小节：

一般注意事项

Team Foundation Server 组帐户名限制

计算机名称限制

团队项目集合名称限制

团队项目名称限制

团队名称限制

工作项限制

工作项自定义限制

过程模板限制

Team Foundation Build 限制

版本控制限制

请参见

一般注意事项

本主题中的长度限制表示为允许的 Unicode 字符的数量。有关 Unicode 的更多信息，请参见“About Unicode and Character Sets”（关于 Unicode 和字符集）(https://go.microsoft.com/fwlink/?LinkId=76837)。代理项字符由两个 Unicode 字符组成，长度限制中会将其算作两个字符。

与其他操作系统文件一样，还禁止 ASCII 控制字符 (ASCII 1-31) 和代理项的组合形式。有关操作系统对文件名的限制的一般信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)。

Team Foundation Server 组帐户名限制

Team Foundation 组帐户允许您将特定权限应用到一组用户。 Team Foundation 组可以由 Windows 用户帐户、Windows 组帐户、Active Directory 组帐户、Team Foundation 组帐户或这些帐户类型的任意组合构成。有关 Users, groups, and permissions in Team Foundation Server deployments 中的用户和组的更多信息，请参见配置用户、组和权限。如果想要怎样在 TFS、SharePoint 产品和 SQL Server Reporting Services 中添加新成员的示例演示，请参见向团队项目中添加用户。如果要了解如何检查您帐户权限的更多信心，请参见管理我的个人资料和查看我的权限。

创建或更改 Team Foundation 组帐户时，必须遵循特定的 Team Foundation Server 限制。下表描述了这些限制。

限制类型	限制
组帐户名长度	不能超过 256 个 Unicode 字符
唯一性（集合级别组帐户）	不能与团队项目集合中的组帐户的任何其他名称匹配
唯一性（项目级别组帐户）	不能与同一项目中的任何其他组名匹配
保留的组名	项目和服务器级别上都不能命名为 $NAMESPACE
特殊字符限制	不能包含以下可打印字符："/ \ [ ] : \| < > + = ; ? * 不能包含 ASCII 值在 1-31 范围内的不可打印字符不能以句点 (.) 结束不能包含逗号 (,)

备注

您不在 Team Foundation Server 中创建用户帐户。

计算机名称限制

在 TFS 安装过程中，计算机名称与服务器的名称相关联。

操作系统和 Active Directory 都对计算机名称有特定的限制规定。有关重命名计算机的更多信息，请参见“Rename a Computer”（重命名计算机）(https://go.microsoft.com/fwlink/?LinkId=76839)。有关 Active Directory 的更多信息，请参见“Windows Server 2003 Active Directory”(https://go.microsoft.com/fwlink/?LinkId=47541)。

团队项目集合名称限制

团队项目集合的名称标识一组团队项目和与这些项目关联的资源。团队项目集合是用于在 TFS 内定义和控制一组团队项目的组织结构。团队成员在连接到 TFS 中的团队项目时，将使用团队项目集合的名称。有关更多信息，请参见使用团队项目集合组织服务器。

下表描述了对集合名称的限制。

限制类型	限制
Length	不能超过 64 个 Unicode 字符
唯一性	不能与 Team Foundation Server 部署中的任何其他集合名称相同。如果部署包括 SharePoint 产品或 SQL Server Reporting Services，则不能与现有 SharePoint 站点、报表服务器或 Reporting Services 网站的名称和完整路径相同。
特殊字符	不能包含任何 Unicode 控制字符或代理项字符。不能包含以下可打印字符：/ : \ ~ & % ; @ ' " ? < > \| # $ * } { , + = [ ] 不能包含省略号 (…) 或双句点 (..) 不能以下划线 (_) 开头不能以句点 (.) 开头或结束
保留名称	不能为系统保留名称，如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON、AUX、Web 或 WEB 有关保留名称的更多信息，请参见 Microsoft 网站上的以下页面：File Names, Paths, and Namespaces（文件名、路径和命名空间）。

项目名称限制

在 TFS 中的项目名称标识一个 TFS 在组成特定项目的集合，集合中包含工作项、文档、报表、团队项目生成以及版本控制树。团队成员将使用此项目名称连接到 TFS 中的项目。

下表描述了对项目名称的限制。

限制类型	限制
Length	不能超过 64 个 Unicode 字符
唯一性	不能与团队项目集合、支持该集合的 SharePoint Web 应用程序或支持该集合的 SQL Server Reporting Services 实例中的任何其他名称相同
特殊字符	不能包含任何 Unicode 控制字符或代理项字符不能包含以下可打印字符：/ : \ ~ & % ; @ ' " ? < > \| # $ * } { , + = [ ] 不能包含省略号 (…) 或双句点 (..) 不能以下划线 (_) 开头不能以句点 (.) 开头或结束
保留名称	不能为系统保留名称，如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX 有关保留名称的更多信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)

团队名称限制

在 TFS 的团队名称标识在 TFS 中的项目集体作为团队一起工作。团队成员将使用此项目名称连接到 Team Web Access 中的此团队。团队名称必须是有效的 URL 可呈现的名称的一部分。此外，单个项目内每个团队名称必须是唯一的，但是，在团队项目集合中的不同项目不禁止使用同一个团队名称。有关使用团队入门中的项目的详细信息，请参阅。

下表描述了对团队名称的限制。

限制类型	限制
Length	不能超过 64 个 Unicode 字符
唯一性	不能与项目中的任何其他名称相同
特殊字符	不能包含任何 Unicode 控制字符或代理项字符不能包含以下可打印字符：/ : \ ~ & % ; @ ' " ? < > \| # $ * } { , + = [ ] 不能包含省略号 (…) 或双句点 (..) 不能以下划线 (_) 开头不能以句点 (.) 开头或结束
保留名称	不能为系统保留名称，如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX 有关保留名称的更多信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)

工作项限制

Microsoft Visual Studio Application Lifecycle Management 使用项（例如 bug、要求、任务和风险）跟踪项目的进度。这些项统称为工作项。本部分描述对存储在工作项中的数据的限制。

工作项附件限制

可以将文件附加到工作项。下表描述了对工作项附件的限制。

限制类型	限制
文件大小	默认情况下，工作项文件附件的大小限制是 4,096 KB。该值可以由 Team Foundation 管理员更改。管理员可设置的最大大小为 2 GB。默认大小：4,096 KB 最大大小：2 GB

工作项区域和迭代限制

工作项包含一个用于**“项目区域”的字段和一个用于“项目迭代”**的字段。这两个字段用于按逻辑分组组织和显示工作项。

**“项目区域”和“项目迭代”**是由多个节点项组成的路径，节点项之间以反斜杠 (\) 字符分隔。节点由 Team Foundation Server 管理员定义，反映项目区域和项目周期。下表描述了对节点和路径的限制。

限制类型	限制
节点长度	不能超过 255 个字符
节点的特殊字符	不能包含 Unicode 控制字符不能包含任何以下字符：\ / $ ? * : " & > < # % \| 不能包含本地文件系统禁止的字符。有关 Windows 字符限制的更多信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)
保留名称	不能仅由一个句点 (.) 或两个句点 (..) 组成不能为系统保留名称，如 PRN、COM1、COM2、COM3、COM4、COM5、COM6、COM7、COM8、COM9、COM10、LPT1、LPT2、LPT3、LPT4、LPT5、LPT6、LPT7、LPT8、LPT9、NUL、CON 或 AUX 有关保留名称的更多信息，请参见“Naming a File”（文件命名）(https://go.microsoft.com/fwlink/?LinkId=76838)
路径长度	不能超过 4000 个 Unicode 字符
路径层次深度	不能超过 14 层

工作项自定义限制

Team Foundation Server 使用诸如缺陷、要求、任务和风险等项来跟踪项目的进度。这些项统称为工作项。

团队项目的管理员可以决定在项目级别上或在过程模板中更改工作项类型定义。有关如何自定义工作项类型的更多信息，请参见自定义项目跟踪数据、窗体、工作流及其他对象。本节描述了您在自定义工作项和与工作项关联的元素时将遇到的限制。

工作项字段名称限制

每个工作项类型包含一个或多个工作项字段。这些字段定义了存储在工作项类型中的信息。工作项字段名称唯一标识每个工作项字段。

下表描述了对工作项字段名称的限制。

限制类型	限制
Length	不能超过 128 个 Unicode 字符
特殊字符	不能包含前导或拖尾空格不能包含两个或更多连续空格不能包含句点 (.) 不能包含左方括号或右方括号 ([ ])
范围	工作项字段名称作用于 TFS 的整个部署。如果更改字段名称，则此更改将反映在包含该工作项字段的所有项目和工作项类型中。

工作项字段引用名称限制

每个工作项字段都有一个关联的字段引用名称。字段引用名称唯一标识每个字段，在指定后便不能更改。下表描述了对字段引用名称的限制。

限制类型	限制
Length	不能超过 70 个 Unicode 字符
特殊字符	不能包含连字符 (-) 必须至少包含一个句点 (.) 不能以句点 (.) 开头或结束不能以数字开头不能以下划线 (_) 开头
唯一性	不能与 Team Foundation Server 中的任何其他字段引用名称相同在计算机使用下划线 (_) 替换这些名称中的所有句点 (.) 之后，该字段引用名称不能与任何其他字段引用名称相同例如，字段引用名称 My._Field 和 My_.Field 都将被计算机处理为同一名称：My__Field

工作项字段帮助文本限制

您可以选择通过使用 <HELPTEXT> 标记将帮助文本与工作项字段关联。系统将在运行时显示此文本，以帮助用户了解应在字段中输入哪些内容。有关工作项字段帮助文本的更多信息，请参见定义工作项字段的帮助文本。

下表描述了对工作项字段帮助文本的限制。

限制类型	限制
Length	不能超过 255 个 Unicode 字符
范围	与字段名和字段类型不同，字段帮助文本的应用范围限定为特定团队项目中的特定工作项类型。

全局列表限制

全局列表是列表项值的集合，该集合由所有 Team Foundation Server 在 Team Foundation Server 实现中存储并在全局范围使用。在定义工作项类型时，您可能会发现一些工作项字段共享一组相同的可能值。使用全局列表可以一次定义这些值并在多个工作项类型中共享这些值。有关更多信息，请参见定义全局列表。

全局列表 (GLOBALLIST) 包含一个或多个列表项（LISTITEM 元素）。

下表描述了对列表项的限制。

限制类型	限制
Length	不能超过 254 个 Unicode 字符不能为空
特殊字符	不能包含前导或拖尾空白不能包含两个连续空格不能包含反斜杠 (\) 字符
范围	因为全局列表在所有项目中都可用，所以不能包含在项目级别定义的元素，例如项目特定的组帐户定义。

下表描述了对全局列表的限制。

限制类型	限制
项个数	全局列表不能为空。它必须至少包含一个 LISTITEM 元素。
唯一性	全局列表名称不能与 Team Foundation Server 中的任何其他全局列表名称相同。

过程模板限制

过程模板是默认工作项、工作项查询、产品模板、报告、安全组和指南的集合，它影响 Team Foundation 项目的结构。 Team Foundation Server 包含两个默认的过程模板，从而提供两种不同的软件周期管理风格。可以自定义这些模板以满足您的组织的独特需求。有关更多信息，请参见自定义过程模板。

下表描述了对过程模板的限制。

限制类型	限制
过程模板名称长度	不能超过 256 个 Unicode 字符。
过程模板名称的唯一性	必须在 Team Foundation 服务器内保持唯一。如果上载与现有模板名称相同的模板，则将覆盖现有模板。
过程模板文件大小	过程模板文件大小不能超过 2 GB（兆字节）。

Team Foundation Build 限制

Team Foundation Build 允许在一台计算机上管理生成过程的所有方面。通过使用 Team Foundation Build，您可以同步源代码、编译应用程序、运行关联的单元测试、执行代码分析、在文件服务器上发布生成，以及发布生成报告。

生成计算机限制

Team Foundation Build 是独立于 Team Foundation Server 应用层、数据层或 Visual Studio 客户端的单独安装。您可以指定单独的计算机。或者，也可以将生成版本并行安装在客户端计算机或服务器上。

下表描述了对生成计算机的限制。

限制类型	限制
磁盘空间	必须具有足够的磁盘空间用于生成（磁盘空间不足将导致生成失败）。
生成目录	必须为本地路径（例如，C:\生成目录）。
放置位置目录	必须为 UNC 路径（例如，\\server\share）。
放置位置权限	每个生成的版本都放在放置文件夹中的新目录中。 Team Foundation Server Service 帐户（例如“域\TFSSERVICE”）对 UNC 放置位置必须具有“完全控制”权限。 UNC 放置位置必须为共享文件夹。
Team Foundation 生成服务帐户	如果在初始安装后更改 TFS Service 帐户，则必须确保符合以下条件。该帐户为“Build Services”组的成员。该帐户对临时文件夹和 ASP.NET 临时文件夹有读/写权限。该帐户对生成目录和放置位置具有“完全控制”权限。
防火墙问题	如果生成计算机启用了防火墙，则请确保 tfsbuildservice 程序位于例外列表中。

生成类型名称

Team Foundation Build 使用生成类型来配置将在团队项目中生成单个解决方案或一组解决方案的条件。若要完成生成，必须创建新生成类型或使用现有的生成类型。有关生成类型的更多信息，请参见定义生成过程。

下表描述了对生成类型名称的限制。

限制类型	限制
唯一性	不能与项目中的任何其他生成类型名称相同
特殊字符	不能包含以下可打印字符：$

生成质量名称

生成质量允许向完成的生成附加质量级别或完成状态。 Team Foundation Build 还允许为生成质量类型创建新值。有关更多信息，请参见创建生成定义。有关默认生成质量值的列表，请参见对已完成生成的质量进行评级。

下表描述了对生成质量名称的限制。

限制类型	限制
Length	不能超过 256 个 Unicode 字符
唯一性	不能与 Team Foundation Build 计算机中的任何其他生成质量名称相同

版本控制限制

Team Foundation 版本控制提供了一个中央存储库，用于存储团队中的文件以及管理这些文件所需的命令。还提供可自定义的签入策略、分支、合并、搁置以及许多其他功能。

版本控制路径

下表描述了版本控制路径上的限制。

限制类型	限制
服务器源管理文件夹路径长度	单个文件夹或文件名称不能超过 259 个 Unicode 字符。目录不能超过 388 个 Unicode 字符。目录和文件名加起来不能超过 399 个 Unicode 字符。
本地文件夹的路径长度	目录不能超过 248 个 Unicode 字符。目录和文件名加起来不能超过 260 个 Unicode 字符。

请参阅：优化工作区。

向版本控制添加文件

版本控制系统存储许多不同类型的文件。有关如何将现有 Visual Studio 项目或解决方案添加到版本控制中的更多信息，请参见设置开发计算机并开始使用版本控制。

下表描述了应用于要添加到版本控制中的文件和文件夹的限制。

限制类型	限制
文件扩展名	不能包含以下可打印字符：/ \ : * ?“ < > \| ;
文件夹	不能为空不能包含有挂起的更改的文件不能位于活动工作区的映射目录之外

标签名称

在 Team Foundation 版本控制中，标签是应用于特定修订集的名称。可以向版本控制中的一组不相关文件附加标签。这使您能够将这些文件作为组进行检索或处理。下表描述了对标签名称的限制。

限制类型	限制
Length	不能超过 64 个 Unicode 字符
特殊字符	不能以空格 ( ) 或句点 (.) 结束不能包含以下可打印字符：" / : < > \ \| * ? @ ;