使用 TFSConfig 在本地管理 Azure DevOps

使用 帐户 命令管理这些 Azure DevOps Server 服务帐户。

• Azure DevOps Server 服务帐户
• SQL Server Reporting Services 的数据源帐户
• Azure DevOps 代理服务器服务帐户

还可以使用此命令更改 Azure DevOps Server 数据库的所有权。

TfsConfig accounts /change|add|set|delete|updatepassword|resetowner
	[/accountType:<adminConsole|applicationTier|proxy|reportingDataSource>]
	[/account:<accountName>] [/password:<password>]
	[/sqlInstance:<serverName>] [/databaseName:<databaseName>] [/continue]

默认值为 ApplicationTier。

sqlInstance 和 databaseName 仅适用于在配置应用程序层之前将帐户添加到数据库时使用。 这主要适用于灾难恢复场景，在运行“仅 AT 配置向导”之前，需要另一个帐户。

添加或更改帐户时，将使用 continue 选项。 对于这些操作，每个数据库中的帐户都会更改。 如果提供了 continue，当集合无法访问时，它将继续运行。 当可以访问它们时，可以再次运行它。

先决条件

若要使用 帐户 命令，你必须是：

• Azure DevOps 管理员安全组
• Azure DevOps Server 实例所使用的所有 SQL Server 实例的系统管理员角色。

如果使用 /proxy 选项，则必须是代理服务器上的管理员。

有关详细信息，请参阅 Azure DevOps Server 权限参考。

注解

使用 帐户 命令自动更改 Azure DevOps Server 的服务帐户、数据库和服务帐户组。 可以配置已创建的帐户，但无法创建帐户。

在更改帐户的域或工作组之前，该帐户必须在应用程序层服务器上具有“帐户为敏感型且不可委派”权限。 有关详细信息，请参阅Microsoft网站上的此页面：启用委派身份验证。

帐户 命令支持本地 Azure DevOps Server 部署。 若要更改 Azure DevOps Services 帐户的帐户所有者，请参阅 更改帐户所有权。

例子

将 Reporting Services 数据源的服务帐户更改为 Contoso 域中的新帐户，帐户名为 Contoso\NewAccount，密码更改为 Password。

TfsConfig accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password

将网络服务系统帐户添加到 Azure DevOps Server 的服务帐户组（系统帐户没有密码）。

TfsConfig accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

将 TFS_Warehouse SQL Server 的 ContosoMain 命名实例上 TeamDatabases 数据库的所有权更改为运行命令的用户帐户。

TfsConfig accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse

可以使用 addProjectReports 命令为现有团队项目添加或覆盖报表。

TfsConfig addProjectReports /collection:<teamProjectCollectionUrl> /teamProject:<projectName> /template:<templateName>
[/force]

先决条件

若要使用 addProjectReports 命令，必须有权运行 TFSConfig，并 将报表上传到 Reporting Service。

注解

当项目没有报表或想要更新为进程定义的报表时，请使用 addProjectReports 命令。

在以下情况下，可能需要使用此命令：

• 该项目是在 Azure DevOps 门户中创建的，而不是从 Visual Studio 创建的
• 该项目是从 Visual Studio 创建的，但未在 Azure DevOps Server 中配置报告。

因为升级了 Azure DevOps Server 使项目中的旧报表不再兼容，如果您想用默认报表覆盖项目中的报表，请使用 /force 选项。 如果已自定义报表，请在执行此作之前进行备份。

若要详细了解如何将报表添加到本地 Azure DevOps Server，请参阅 向项目添加报表。

示例

以下示例演示如何将 Agile 报表添加到 MyProject 项目集合中的 http://myTfsServer:8080/tfs/DefaultCollection 项目。

TFSConfig addProjectReports /collection:http://myTfsServer:8080/tfs/DefaultCollection /teamproject:MyProject /template:Agile

身份验证 命令更改 Azure DevOps Server 应用程序层或代理网站使用的网络身份验证协议。

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]

先决条件

若要使用 身份验证 命令，你必须是应用程序层服务器或代理服务器上的 Azure DevOps 管理员安全组和本地管理员的成员，具体取决于 siteType 选项的值。

注解

身份验证 命令由想要更改 Azure DevOps Server 所依赖的一个或多个网站的网络身份验证协议的管理员使用。 管理员从应用程序层运行此命令，以更新需要更改其网络身份验证协议的网站。 该命令更改 IIS 元数据库中 NTAuthenticationProviders 属性。

在使用 身份验证 命令更改身份验证协议之前，可以使用 /viewAll 选项运行该命令，以查看现有设置是什么。

示例

以下示例显示为网络身份验证协议分配的当前值。

TFSConfig Authentication /viewAll

使用 证书 命令更改在使用 HTTPS、安全套接字层 (SSL) 和证书的 Azure DevOps Server 部署中，证书用于配置客户端身份验证的方式。

TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]

先决条件

若要使用 证书 命令，你必须是运行该命令的计算机上的 Azure DevOps Administrators 安全组和本地管理员组的成员。 有关详细信息，请参阅 Azure DevOps Server 权限参考。

注解

默认情况下，证书 命令会自动从当前用户的证书列表中选择客户端证书。 但是，可以使用命令的选项从当前用户上下文或本地计算机上下文指定特定的证书或证书。

在使用 证书 命令之前，必须先配置 Azure DevOps Server 部署中的服务器以利用证书。 有关详细信息，请参阅 为 Azure DevOps Server设置具有安全套接字层 （SSL） 的 HTTPS。

可以使用 证书 命令来配置 Azure DevOps Server 部署所使用的客户端证书，该服务器已被配置为使用 HTTPS/SSL 和证书。 如果使用没有选项的 Certificates 命令，将从运行命令的当前用户上下文中自动选择客户端证书。

例子

以下示例演示如何指定具有指纹 aa bb cc dd ee 且没有提示的本地计算机证书。

TfsConfig certificates /machine /thumbprint:aa bb cc dd ee /noprompt

以下示例说明如何通过自动选择从当前用户存储中指定客户端证书。

TfsConfig certificates /autoselect

changeServerID 命令更改与 Azure DevOps Server 数据库关联的 GUID。 GUID 在 Azure DevOps Server 的部署中必须是唯一的。 如果多个数据库具有相同的 GUID，则部署可能会变得不稳定或不可用。 可以更改配置数据库的 GUID、部署中所有项目集合数据库的 GUID，或者两者的 GUID 都可以更改。

尽管通常不会在日常作中使用此命令，但在以下情况下，可以使用此命令：

• 已将部署还原到新硬件，旧部署仍可正常运行，并且想要同时使用这两个部署。 此方案有时称为克隆服务器。

• 想要在重复部署上测试软件更新或硬件配置，以免中断生产环境。

• 你需要在测试实验室或独立环境中对数据库全面测试还原到新硬件，以确保能够还原部署。

• 将集合数据库移动到已保留该 GUID 的另一个部署后，必须重置集合数据库的 GUID。

TfsConfig changeServerID /sqlInstance:<serverName> /databaseName:<configurationDatabaseName>
	[/projectCollectionsOnly] [/configDBOnly] [/collectionName]

先决条件

若要使用 changeServerID 命令，你必须是 Azure DevOps Administrators 安全组的成员，并且是 Azure DevOps Server 使用的所有 SQL Server 实例的 sysadmin 安全角色的成员。 有关详细信息，请参阅 Azure DevOps 权限参考。

注解

使用 changeServerID 命令创建用于测试或克隆目的的 Azure DevOps Server 部署的离散副本。 使用 changeServerID 命令后，必须先指示客户端创建与已更改服务器的连接，然后才能使用它。

示例

以下示例演示如何更改 Azure DevOps Server 的 Contoso1 部署中所有数据库的 GUID，其中配置数据库托管在命名为 ContosoMain 的服务器上的 SQL Server 实例 TeamDatabases 中。

TfsConfig changeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

使用 codeIndex 命令管理 Azure DevOps Server 上的代码索引。 例如，你可能想要重置索引以修复 CodeLens 信息，或关闭索引以调查服务器性能问题。

TfsConfig codeIndex /indexingStatus | /setIndexing:[on|off|keepupOnly] |
	/ignoreList:[ add | remove | removeAll | view ] <serverPath> |
	/listLargeFiles [/fileCount:FileCount] [/minSize:MinSize] |
	/reindexAll | 
    /destroyCodeIndex [/noPrompt] |
	/temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] |
	/indexHistoryPeriod:[ view | all | <NumberOfMonths> ] [/collectionName:<collectionName> | /collectionId:<collectionId>]

先决条件

若要使用 codeIndex 命令，你必须是 Azure DevOps Administrators 安全组的成员。 请参阅 Azure DevOps Server 的权限参考。

例子

若要查看代码索引状态和配置，请执行以下作：

TfsConfig codeIndex /indexingStatus /collectionName:"Fabrikam Web Site"

开始为所有变更集编制索引

TfsConfig codeIndex /setIndexing:on /collectionName:"Fabrikam Web Site"

停止为之前创建的变更集创建索引，开始仅为新的变更集创建索引：

TfsConfig codeIndex /setIndexing:keepupOnly /collectionName:"Fabrikam Web Site"

若要查找最多 50 个大于 10 KB 的文件，

TfsConfig codeIndex /listLargeFiles /fileCount:50 /minSize:10 /collectionName:"Fabrikam Web Site"

若要从索引中排除特定文件并将其添加到忽略的文件列表：

TfsConfig codeIndex /ignoreList:add "$/Fabrikam Web Site/Catalog.cs" /collectionName:"Fabrikam Web Site"

若要查看未编制索引的所有文件，

TfsConfig codeIndex /ignoreList:view

若要清除以前编制索引的数据并重启索引，

TfsConfig codeIndex /reindexAll /collectionName:"Fabrikam Web Site"

保存所有变更集历史记录：

TfsConfig codeIndex /indexHistoryPeriod:all /collectionName:"Fabrikam Web Site"

若要删除 CodeLens 临时数据的大小限制并继续编制索引，而不考虑临时数据大小：

TfsConfig codeIndex /temporaryDataSizeLimit:disable /collectionName:"Fabrikam Web Site"

要删除代码索引，请确认：

TfsConfig codeIndex /destroyCodeIndex /collectionName:"Fabrikam Web Site"

可以使用 集合 命令从 Azure DevOps Server 的部署中附加、分离或删除项目集合。 还可以使用 集合 命令复制现有集合的数据库，将其重命名，并将其附加到部署。 此过程有时称为克隆集合。

TfsConfig collection {/attach | /create | /detach | /delete} [/collectionName:<collectionName>]
    [/description:<collectionDescription>]
    [/collectionDB:<serverName>;<databaseName>]
    [/processModel:Inheritance|Xml]
    [/reportingFolder:<reportingFolderPath>]
    [/clone] [/verify] [/continue]

先决条件

若要使用 集合 命令，你必须是 Team Foundation Administrators 安全组的成员以及运行 TfsConfig的计算机上的本地管理员组。 还必须是 Azure DevOps Server 数据库使用的所有 SQL Server 实例的 sysadmin 安全角色的成员。 如果您的部署与 SharePoint 集成，并且您使用的是 /delete 选项，则您还必须是从中删除网站集合的 SharePoint 场所在场管理员组的成员。

有关详细信息，请参阅 Azure DevOps Server 权限参考。

注解

若要以交互方式管理集合或创建集合，可以使用 Azure DevOps 管理控制台中的项目集合节点。 请参阅 管理项目集合。

例子

以下示例演示如何从 Azure DevOps Server 的部署中永久删除 Contoso Summer Intern Projects 项目集合。

TfsConfig collection /delete /CollectionName:"Contoso Summer Intern Projects"

TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.
Deleting a project collection is an irreversible operation. A deleted collection cannot be reattached to the same or another Team Foundation Server. Are you sure you want to delete 'Contoso Summer Intern Projects'? (Yes/No)
Yes
Found Collection 'Contoso Summer Intern Projects' Deleting...
The delete of collection 'Contoso Summer Intern Projects' succeeded.

以下示例演示如何复制 Contoso Summer Interns Projects 项目集合，将其命名为 Contoso Winter Interns Projects，并将重复集合附加到 Azure DevOps Server 的部署。

TfsConfig collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects"
    /CollectionName:"Contoso Winter Intern Projects" /clone

可以使用 columnStoreIndex 命令为 Azure DevOps Server 部署使用的数据库启用或禁用列存储索引。

TfsConfig columnStoreIndex /enabled:<true|false>
	/sqlInstance:<serverName>
	/databaseName:<databaseName>

先决条件

若要使用 columnStoreIndex 命令，必须是指定 SQL Server 实例的 sysadmin 角色的成员。

注解

如果要将支持列存储索引的 SQL 实例移动到不支持的列存储索引的 SQL 实例，则通常使用 columnStoreIndex 命令。 在这种情况下，需要禁用所有列存储索引，然后才能成功移动数据库。 同样，如果要将数据库移回支持的列存储索引的 SQL 实例，你可能希望重新启用列存储索引以节省空间并提升性能。

示例

在以下示例中，演示如何在名为 TFS_DefaultCollection的 SQL 实例上，为位于服务器 ContosoMain 上的运行中的数据库 TeamDatabases 启用列存储索引。

TfsConfig columnStoreIndex /enabled:true /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection

可以使用 dbCompression 命令为 Azure DevOps Server 部署使用的数据库启用或禁用数据库页压缩。

TfsConfig dbCompression /pageCompression:[enable|disable]
	/sqlInstance:<serverName>
	/databaseName:<databaseName>
	[/rebuildNow [/offline]]

先决条件

若要使用 dbCompression 命令，必须是指定 SQL Server 实例的 sysadmin 角色的成员。

注解

如果将数据库从支持压缩的 SQL 实例移动到不支持压缩的 SQL 实例，则通常使用 dbCompression 命令。 在这种情况下，需要禁用压缩和解压缩所有索引，然后才能成功移动数据库。 同样，如果要将数据库移回支持压缩的 SQL 实例，则可能需要重新启用压缩以节省空间。

此命令仅更改 Azure DevOps Server 是否倾向于使用数据库页压缩 - 数据库仍必须托管在支持压缩的 SQL 实例中。 有关详细信息，请参阅 SQL Server 各版本支持的 功能。

示例

以下示例演示如何为服务器 TFS_DefaultCollection 上 SQL 实例 ContosoMain的名为 TeamDatabases 的数据库立即启用页面压缩，并联机重建索引。

TfsConfig dbCompression /pageCompression:enable /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /rebuildNow

可以使用 deleteTestResults 命令从集合存储中删除旧的存储测试结果。 这通常是为了减小存储大小或减少将测试结果迁移到新架构所需的时间。

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]

先决条件

若要使用 deleteTestResults 命令，必须是指定 SQL Server 实例的 sysadmin 角色的成员。

注解

使用 /preview 参数查看按项目名称和年份排序的测试结果，而无需删除这些结果。

示例

以下示例演示如何删除在服务器 TFS_DefaultCollection 上的 SQL 实例 ContosoMain中名为 TeamDatabases 的数据库里超过 60 天的手动测试结果。

TfsConfig deleteTestResults /ageInDays:60 /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /type:manual

deploymentPool 命令旨在将所有部署组从一个部署池迁移到另一个部署池。

TfsConfig deploymentpool /migrateDeploymentGroups /fromPool:<source pool name> /toPool:<destination pool name>

标识的 命令用于列出或更改 Azure DevOps Server 部署中用户和组的安全标识符 (SID)。 在以下方案之一中，可能需要更改或更新用户和组的 SID：

• 更改您的部署域

• 从工作组更改为域或从域更改为工作组

• 在 Active Directory 中跨域迁移帐户

TfsConfig identities [/change /fromdomain:<domainName1> /todomain:<domainName2>
    [/account:<accountName> [/toaccount:<accountName>]] [/sqlInstance:<serverName> /databaseName:<databaseName>]

先决条件

若要使用 标识 命令，你必须是 Team Foundation Administrators 安全组的成员，并且是 Team Foundation Server 使用的所有 SQL Server 实例的 sysadmin 角色的成员。 有关详细信息，请参阅 为 Azure DevOps Server设置管理员权限。

注解

可以选择在为部署配置应用程序层服务器之前指定要更改标识的数据库。 例如，在克隆 Azure DevOps Server 的部署时，可以指定要更改服务帐户的数据库。

更改标识时，目标帐户或帐户必须已存在于 Windows 中。

您必须等到与 Windows 的下一个身份同步完成后，才能更新通过此命令更改的帐户属性。 此要求包括从组更改为用户、从用户更改为组，以及从域帐户更改为本地帐户。

例子

以下示例演示如何列出 Azure DevOps Server 中存储的所有 Windows 用户和组的名称，并显示每个用户或组的 SID 是否与 Windows 中的 SID 匹配。 Contoso1 域管理员创建了域组，例如 Contoso1\\Developers 和 Contoso1\\Testers，以帮助简化跨 Azure DevOps Server、SQL Server Reporting Services 和 SharePoint 产品的权限管理。

TfsConfig identities

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.

    Account Name Exists (see note 1) Matches (see note 2)
    --------------------------------------------------------------------
    CREATOR OWNER True True
    Contoso1\hholt True True
    BUILTIN\Administrators True True
    Contoso1\Developers True True
    Contoso1\Testers True True
    Contoso1\PMs True True
    Contoso1\jpeoples True True
    Contoso1\Domain Admins True True
    Contoso1\SVCACCT1 True True

    9 security identifiers (SIDs) were found stored in Team Foundation Server. Of these, 9 were found in Windows. 0 had differing SIDs.

以下示例演示如何将 Azure DevOps Server 中所有帐户的 SID 从 Contoso1 域更改为在 ContosoPrime 域中具有匹配名称的帐户的 SID。 只有匹配的帐户名称才会更新与其对应的 SID。 例如，如果 hholt 帐户作为 Contoso1\hholt 和 ContosoPrime\hholt存在，则帐户 SID 将更改为 ContosoPrime\hholt的 SID。 如果 ContosoPrime\hholt 帐户不存在，则不会为 Contoso1\hholt更新 SID。

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

以下示例演示如何将用户帐户 Contoso1\hholt更改为另一个用户帐户 ContosoPrime\jpeoples。

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

以下示例演示如何在将部署域从 NT AUTHORITY\NETWORK SERVICE 更改为 Contoso1时，更改 Azure DevOps Server 部署中使用的 ContosoPrime 服务帐户的 SID。 若要更改系统帐户（如网络服务），必须遵循两个阶段的过程。 首先将服务帐户从 NT AUTHORITY\NETWORK SERVICE 更改为新域 TempSVC中的域帐户，然后在新域的服务器上将帐户更改回为 NETWORK SERVICE。 配置数据库托管在名为 ContosoMain 的 SQL Server 服务器上的命名实例 TeamDatabases 中。

TfsConfig identities /change /fromdomain:"NT AUTHORITY" /todomain:ContosoPrime /account:"NETWORK SERVICE"
  /toaccount:TempSVC /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

TfsConfig identities /change /fromdomain:ContosoPrime /todomain:"NT AUTHORITY" /account:TempSVC
	/toaccount:"NETWORK SERVICE"

可以使用 作业 命令创建一个日志文件，该文件提供特定项目集合的最新作业活动的详细信息，或重试一个或多个项目集合的作业。

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]

先决条件

若要使用 作业 命令，你必须是 Azure DevOps Administrators 安全组的成员。 有关详细信息，请参阅 Azure DevOps Server 权限参考。

注解

若要以交互方式重试作业，可以打开 Azure DevOps 的管理控制台，选择集合的 状态 选项卡，然后选择 重试作业。 有关详细信息，请参阅 打开 Azure DevOps 管理控制台。

示例

以下示例演示如何创建一个日志文件，该文件列出 Azure DevOps Server 中 Contoso Summer Intern Projects 项目集合的最新作业活动。

TfsConfig jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"

可以使用 offlineDetach 命令将脱机集合数据库转换为分离的脱机集合数据库。

TfsConfig offlineDetach /configurationDB:<databaseName>
    /collectionDB:<databaseName>

先决条件

若要使用 offlineDetach 命令，

• 必须是指定 SQL Server 实例的 sysadmin 角色的成员。
• TFSConfig 工具的版本必须与 Azure DevOps Server 数据库的版本匹配。

注解

此命令修改指定的集合数据库的架构，并且不应针对 Azure DevOps Server 部署正在使用的数据库运行。 如果数据库由 Azure DevOps Server 部署使用，请改用 TfsConfig collection /detach 。

如果需要从备份还原单个集合数据库，而不还原属于同一 Azure DevOps Server 部署的其他集合数据库，此命令非常有用。 以前，这需要将一组完整且一致的数据库（配置和所有集合）还原到过渡环境，使用这些数据库配置 Azure DevOps Server 部署，以及分离感兴趣的一个集合。

现在，您可以还原配置数据库和相关集合数据库的一致性副本，然后运行 offlineDetach 命令。 然后，已分离的集合数据库可以附加到任何适用于相应版本的 Azure DevOps Server 部署中。

示例

下面的示例展示了如何使用名为 TFS_PrimaryCollection的配置数据库来分离名为 TFS_Configuration的集合数据库，这些数据库都在服务器 ContosoTemp 上的名为 Backups的 SQL 实例中运行。

TfsConfig offlineDetach /configurationDB:ContosoTemp\Backups;TFS_Configuration /collectionDB:ContosoTemp\Backups;TFS_PrimaryCollection

可以使用 代理 命令更新或更改 Azure DevOps 代理服务器使用的设置。 Azure DevOps 代理服务器通过管理分布式团队位置中下载的版本控制文件的缓存来支持分布式团队使用版本控制。 通过配置 Azure DevOps 代理服务器，可以显著减少跨广域连接所需的带宽。 此外，无需管理版本文件的下载和缓存;文件管理对使用文件的开发人员是透明的。 同时，任何元数据交换和文件上传将继续显示在 Azure DevOps Server 中。 如果使用 Azure DevOps Services 在云中托管开发项目，可以使用 Proxy 命令不仅管理托管集合中项目的缓存，还可以管理该服务使用的一些设置。

有关安装 Azure DevOps 代理服务器和代理的初始配置的详细信息，

请参阅如何：安装 Azure DevOps 代理服务器并设置远程站点。 有关在客户端计算机上配置代理的详细信息，请参阅 Azure DevOps 版本控制命令参考。

TfsConfig proxy /add|delete|change [/Collection:<teamProjectCollectionURL> /account:<accountName>]
	/Server:<TeamFoundationServerURL> [/inputs:Key1=Value1; Key2=Value2;...] [/continue]

先决条件

若要使用 代理 命令，你必须是 Azure DevOps 管理员安全组的成员和代理服务器上的管理员。 有关详细信息，请参阅 Azure DevOps Server 的权限参考。

注解

使用 代理 命令更新 Azure DevOps Server 代理的现有配置。 不能将 代理 命令用于代理的初始安装和配置。

例子

以下示例演示如何将名为 FABRIKAM 的 Azure DevOps Server 部署添加到代理列表中。

TfsConfig proxy /add /Server:http://www.fabrikam.com:8080/tfs 

以下示例演示如何使用 个人访问令牌 向代理列表添加托管在 Azure DevOps Services 上的项目集合进行身份验证。 此令牌仅用于向 Azure DevOps Services 帐户注册代理 - 默认服务帐户仍将用于运行代理。 在 TFS 2018 Update 1 中添加了此参数，以支持向 Azure DevOps Services 注册代理，而无需登录提示。

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver

以下示例演示如何将项目集合添加到代理列表。 此示例使用个人访问令牌对使用 /Collection 参数指定的集合进行身份验证。 要使用的个人访问令牌将被保存到文件 c:\PersonalAccessToken.txt中。

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/PersonalAccessTokenFile:c:\PersonalAccessToken.txt

以下示例演示如何更改代理供 Azure DevOps Services 上托管的项目集合服务使用的服务帐户。 集合命名为 PhoneSaver，用于 Azure DevOps Services 的帐户名称 HelenaPetersen.fabrikam.com，代理使用的服务帐户将更改为 My Proxy Service Account。 由于帐户名称包含空格，因此使用引号将名称括起来。

TfsConfig proxy /change /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/account:"My Proxy Service Account"

以下示例演示如何添加用于 GVFS 的 Git 存储库。

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver /inputs:GvfsProjectName=PhoneSaver;GvfsRepositoryName=AnotherRepository

可以使用 rebuildWarehouse 命令重新生成 Azure DevOps Server 使用的 SQL Server Reporting Services 和 SQL Server Analysis Services 数据库。

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]

先决条件

若要使用 rebuildWarehouse 命令，你必须是以下组的成员：

• Azure DevOps 管理员安全组以及运行 Azure DevOps 管理控制台的服务器上的管理员安全组

• 运行托管 Azure DevOps Server 数据库的 SQL Server 实例的服务器或服务器上的 sysadmin 组

有关详细信息，请参阅 Azure DevOps Server 权限参考。

注解

移动或拆分项目集合、还原数据或者更改部署的配置时，可以使用此命令。

若要以交互方式重新生成这些数据库，可以使用 Azure DevOps 管理控制台中的报告节点。 有关详细信息，请参阅 打开 Azure DevOps 管理控制台。

示例

以下示例演示如何重新生成 Analysis Services 数据库以部署 Azure DevOps Server。

TfsConfig rebuildWarehouse /analysisServices

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.
    The Analysis Services database was successfully rebuilt.

使用 registerDB 更新在 Azure DevOps Server 中托管配置数据库的服务器的名称。 将配置数据库还原到新硬件或更改部署域时，可以使用此命令。

TfsConfig registerDB /sqlInstance:<serverName> /databaseName:<databaseName>

先决条件

若要使用 registerDB 命令，你必须是 Azure DevOps 应用程序层服务器上的 Azure DevOps 管理员组的成员，并且是 Azure DevOps 数据层服务器上 SQL Server 中 sysadmin 组的成员。 有关详细信息，请参阅 Azure DevOps Server 权限参考。

注解

使用此命令之前，请备份 Azure DevOps Server 的数据库。

若要使 registerDB 命令成功，必须运行以下应用程序池和程序：

• Azure DevOps Server 应用程序池（应用程序池）
• ReportServer （应用程序池）
• SQL Server Reporting Services （程序）

必须提供配置数据库的确切名称或地址，才能使此命令正常运行。 如果必须更改存储此数据库的服务器，必须确保 Azure DevOps Server 指向新位置。

示例

以下示例将 Azure DevOps Server 重定向到位于 SQL Server 实例中的服务器 ContosoMain 的配置数据库 TeamDatabases。

TfsConfig registerDB /SQLInstance:ContosoMain\TeamDatabases /databaseName:Tfs_Configuration

remapDBs 命令用于在数据库存储在多个服务器上时，Azure DevOps Server 重定向到其相应的数据库，尤其是在您还原、移动或更改部署配置时。 例如，如果项目集合的数据库托管在与配置数据库不同的服务器上，则必须将 Azure DevOps Server 重定向到这些数据库。 如果这些数据库托管在与配置数据库的单独服务器或实例上，则还必须将 Azure DevOps Server 重定向到运行 SQL Server Analysis Services 或 SQL Server Reporting Services 的服务器。

TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
	[/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
	[/preview] [/continue]

先决条件

若要使用 remapDB 命令，你必须是 Azure DevOps Administrators 安全组的成员，并且是 Azure DevOps Server 使用的任何 SQL Server 数据库的 sysadmin 安全组的成员。 有关详细信息，请参阅 Azure DevOps Server 权限参考。

注解

您可以使用 remapDBs 命令重新配置 Azure DevOps Server，以便使用不同的服务器和 SQL Server 实例，而不是原始安装中的服务器和实例。

示例

以下示例演示如何将 Azure DevOps Server 重定向到其配置数据库 TFS_Configuration。 此数据库托管在命名实例 ContosoMain的 TeamDatabases 上。 其项目集合数据库存储在 ContosoMain\TeamDatabases 和 Contoso2的默认实例上。

TfsConfig remapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
	/SQLInstances:ContosoMain\TeamDatabases,Contoso2

可以使用 repairJobQueue 命令来修复那些为部署和集合主机而停止运行的计划作业。

TfsConfig repairJobQueue

先决条件

若要使用 repairJobQueue 命令，你必须是运行 TfsConfig的计算机上的本地管理员组的成员。 您还必须是 Azure DevOps Server 部署所用的所有 SQL Server 实例中的 sysadmin 安全角色的成员。

注解

如果发现任何计划作业未运行，通常会使用 repairJobQueue 命令。
该命令不采用任何参数，并且需要配置 Azure DevOps Server 部署。

示例

TfsConfig repairJobQueue

可以使用 设置 命令自动更改通知接口使用的统一资源定位符（URL），以及 Azure DevOps Server 的服务器地址。 默认情况下，通知接口 URL 和服务器 URL 在 Azure DevOps Server 中匹配，但可以配置单独的 URL。 例如，你可能想要为 Azure DevOps Server 生成的自动电子邮件使用不同的 URL。 必须从应用程序层运行此工具以更新所有服务器，以便它们使用新的 URL。

若要以交互方式更改这些 URL 或仅查看当前设置，可以使用 Azure DevOps 的管理控制台。 请参阅 管理任务快速参考。

TfsConfig settings [/publicURL:URL]

先决条件

你必须是 Azure DevOps 管理员安全组的成员和应用程序层服务器上的管理员组。 有关详细信息，请参阅 为 Azure DevOps Server设置管理员权限。

注解

设置命令 可以更改 Azure DevOps Server 部署中服务器之间通信的连接信息。 /publicURL 中指定的 URL 必须可供部署中的所有服务器使用。

示例

以下示例将 NotificationURL 的值更改为 http://contoso.example.com/tfs，将 ServerURL 的值更改为 http://contoso.example.com:8080/tfs。

TfsConfig settings /publicURL:http://contoso.example.com:8080/tfs

升级到最新版本的 Azure DevOps Server 时，系统会自动尝试升级测试管理组件，包括测试计划和套件。

如果自动迁移失败，请使用 TCM 命令手动将测试计划和测试套件升级到各自的工作项类型（WIT）。

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

先决条件

你必须是 Team Foundation 管理员安全组的成员，并且是应用程序层服务器上的管理员。

请参阅 为 Azure DevOps Server设置管理员权限。

注解

应用程序层服务器必须升级到最新版本的 Azure DevOps Server 2019 才能使用此命令。

在使用 TCM 命令之前，必须先将测试计划工作项定义和测试计划类别导入项目中。

若要详细了解迁移以及何时使用此命令，请参阅 手动更新以支持测试管理。

TCM 命令应用于单个项目。 如果需要升级多个项目中的测试计划，则必须单独针对每个项目运行它。

必须从 Azure DevOps Server 的工具目录中运行 TCM 命令。 默认情况下，该位置为：drive:\%programfiles%\TFS 12.0\Tools。

仅当自动迁移现有测试数据失败时，才使用 TCM 命令。

若要详细了解迁移以及何时使用此命令，手动更新以支持测试管理。 如果无法访问在服务器升级发生前定义的测试计划或测试套件，请运行 TFSConfig TCM upgradeStatus 来确定迁移的状态。

为单个项目运行 TCM 命令。 如果需要升级多个项目，则必须对每个项目依次执行升级操作。

例子

以下示例演示如何检查默认项目集合上托管的 Fabrikam Fiber 项目的测试计划升级状态（DefaultCollection）：

tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"

命令可用性： Azure DevOps Server 2019

无人参与 命令专为熟悉 Azure DevOps Server 和配置过程以及需要在不同的计算机上安装 Azure DevOps Server 的用户而设计。

例如，如果使用 Azure DevOps Build，则可以使用 无人参与 命令来使用相同的配置文件安装多个生成服务器。

使用 /create 选项创建无人参与文件。 此文件定义 Azure DevOps Server 安装的所有配置参数。 接下来，使用 /configure 选项实际执行配置。

此过程允许从头到尾配置 Azure DevOps Server，而无需在安装过程中提供输入。 对于多个安装，这也有助于确保跨多个服务器使用相同的配置参数。

TfsConfig unattend /create|configure /type:InstallType /unattendfile:ConfigurationFileName 
    [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]

先决条件

• 你必须是安装软件的计算机上的 Administrators 组的成员。

• 根据安装类型，可能还需要其他管理员权限。

例如，如果使用 无人参与 命令来安装 Azure DevOps Server，则您必须是支持 Azure DevOps Server 的 SQL Server 实例上的 sysadmin 组成员。 有关详细信息，请参阅 将服务器级管理员添加到 Azure DevOps Server的 Q & A 部分。

注解

在使用 无人参与安装 命令配置 Azure DevOps Server 之前，您必须 创建将用作部署一部分的服务帐户。 还必须为所选安装类型安装任何必备软件。 这包括 Azure DevOps Server 本身。 必须安装 Azure DevOps Server，但不用配置它，因为 无人参与 命令会自动为你完成配置。

无人值守 命令配置 Azure DevOps Server 组件。 它不执行软件的初始安装。 它在计算机安装完成后根据您的要求配置软件。

例子

以下示例演示如何为 Azure DevOps Server 的基本安装创建无人参与文件。

TfsConfig unattend /create /type:basic /unattendfile:configTFSBasic.ini

在此示例中，无人参与文件是在命令所在的同一目录中创建的。 日志文件作为命令的一部分创建，并在执行命令时在命令中返回文件的位置。

以下示例演示如何在配置过程中指定用于 GVFS 的 Git 存储库。

TfsConfig unattend /configure /type:proxy /inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection;GvfsProjectName=Fabrikam-Fiber-Git;GvfsRepositoryName=TestGit

以下示例演示如何为 Azure DevOps 代理服务器的配置创建无人参与文件。

TfsConfig unattend /create /type:proxy "/inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection" /unattendFile:c:\unattend.txt

以下示例演示如何使用 FabrikamFiber\BuildSVC 作为生成服务的帐户，在服务器上为 Azure DevOps Server 构建服务配置创建无人参与文件，然后使用该无人参与文件对 Azure DevOps Server 构建服务进行配置。

TfsConfig unattend /create /type:build /unattendfile:configTFSBuild.ini
    /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

第一个命令返回以下内容：

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203133.log

第二个命令返回以下信息，包括配置 Azure DevOps Build 的服务器的名称 FabrikamFiberTFS 以及与控制器 DefaultCollection关联的项目集合：

    Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
    Copyright (c) Microsoft Corporation. All rights reserved.

    Command: unattend

    ---------------------------------------------
            Inputs:
    ---------------------------------------------

    Feedback
            Send Feedback: True

    Build Resources
            Configuration Type: create
            Agent Count: 1
            New Controller Name: FabrikamFiberTFS - Controller
            Clean Up Resources: False

    Project Collection
            Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

    Windows Service
            Service Account: FabrikamFiber\BuildSVC
            Service Password: ********

    Advanced Settings *
            Port: 9191

    ---------------------------------------------
            Running Readiness Checks
    ---------------------------------------------

    [1/2] System Verifications
    [2/2] Build Service Verifications

    ---------------------------------------------
            Configuring
    ---------------------------------------------

            root
    [1/4] Install Team Foundation Build Service
            Installing Windows services ...
            Adding service account to groups ...
            Setting ACL on a windows service
    [2/4] Enable Event Logging
            Adding event log sources ...
            Token replace a config file
            RegisterBuildEtwProvider
            Configuring ETW event sources ...
    [3/4] Register with Team Foundation Server
            Registering the build service
    [4/4] Start Team Foundation Build Service
            StartBuildHost
            Starting Windows services ...
            Marking feature configured status
    [Info] [Register with Team Foundation Server] Firewall exception added for port
    9191

    TeamBuild completed successfully.
    Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

ziplogs 命令旨在收集日志，并将生成一个 zip 文件放在 ProgramData\Microsoft\Azure DevOps\Server Configuration。

TfsConfig zipLogs

TfsConfig zipLogs