Использование TFSConfig для управления локальной средой Azure DevOps

Статья
04/03/2024

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

С помощью средства командной строки TFSConfig можно выполнить различные административные действия для локального развертывания Azure DevOps.

TFSConfig можно запускать с любого компьютера, на котором установлен сервер Azure DevOps.

Расположение средства командной строки

Средства командной строки Azure DevOps устанавливаются в каталог /Tools сервера уровня приложений Azure DevOps.

Azure DevOps Server 2020: %programfiles%\Azure DevOps Server 2020\Tools
Azure DevOps Server 2019: %programfiles%\Azure DevOps Server 2019\Tools
TFS 2018: %programfiles%\Microsoft Team Foundation Server 2018\Tools
TFS 2017: %programfiles%\Microsoft Team Foundation Server 15.0\Tools
TFS 2015: %programfiles%\Microsoft Team Foundation Server 14.0\Tools
TFS 2013: %programfiles%\Microsoft Team Foundation Server 12.0\Tools
TFS 2012: %programfiles%\Microsoft Team Foundation Server 11.0\Tools
TFS 2010: %programfiles%\Microsoft Team Foundation Server 2010\Tools

Предпосылки

Чтобы многие команды работали правильно, TFSConfig потребуется подключиться к различным серверам и службам, которые являются частью развертывания TFS, и пользователю, работающему TFSConfig потребуется иметь административные разрешения для этих же серверов и служб. Требования к конкретным командам будут перечислены далее.

Многие команды TFSConfig должны выполняться из командной строки с повышенными привилегиями, даже если у работающего пользователя есть учетные данные администратора. Чтобы открыть командную строку с повышенными привилегиями, нажмите кнопку "Пуск", щелкните правой кнопкой мыши командную строку и выберите команду "Запустить от имени администратора". Дополнительные сведения см. в статье контроль учетных записей пользователей.

Вы также можете выполнять административные действия в интерактивном режиме с помощью консоли администрирования для Azure DevOps Server. См. краткий справочник административных задач .

Вывод списка команд и получение справки

Чтобы отобразить полный список команд TFSConfig, используйте команду help.

TFSConfig help

Чтобы получить справку по отдельной команде, используйте команду справка и укажите имя команды, для которой требуется справка. Например, чтобы получить справку для учетных записей :

TFSConfig help accounts

Учетные записи

Используйте команду accounts для управления этими учетными записями службы 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]

Операция	Описание
ОбновитьПароль	Изменяет пароль учетной записи, которая используется в качестве учетной записи службы. Изменяет существующую учетную запись и все accountTypes, которые выполняются как данная учетная запись.
Изменение	Изменяет учетную запись, используемую в качестве учетной записи службы. Добавляет новую учетную запись в необходимые ресурсы и группы, предоставляет необходимые разрешения, а затем задает службу для ее использования. Это не удаляет старую учетную запись из ресурсов. Если вы не используете параметр accountType, учетная запись службы для уровня приложений будет изменена.
Добавь	Добавляет новую учетную запись только к необходимым ресурсам. Полезно для сценариев NLB. Используйте флаг продолжения, если некоторые коллекции недоступны. Добавление можно выполнить снова позже, чтобы обновить все пропущенные коллекции. Учетная запись добавляется в группы, необходимые для использования её в качестве сервисной учетной записи.
Установить	Настраивает службу на использование учетной записи, которая уже добавлена в ресурсы. Полезно для сценариев NLB.
Удалить	Удаляет учетную запись из всех ресурсов. Меры предосторожности следует использовать при удалении учетной записи, так как это может привести к отказу на других серверах.
ResetOwner	Если базы данных восстанавливаются в рамках перемещения, клонирования или аварийного восстановления, владелец базы данных может переключиться на администратора, который восстанавливает сервер. Этот параметр выполняет итерацию по всем базам данных и задает имя входа dbo текущему владельцу.

ТипАккаунта	Описание
AdminConsole	Пользователи консоли администрирования — это пользователи, которым предоставлены минимальные разрешения для различных ресурсов для использования консоли.
Уровень приложения	Изменяет учетную запись службы в AppPool для основных веб-служб. (TFSService)
Прокси	Изменяет учетную запись службы в AppPool для прокси веб-служб. (TFSProxy)
РепортингДатаСорс	Изменяет учетную запись, которую отчеты используют для доступа к данным отчетов. (TFSReports)

Значение по умолчанию — ApplicationTier.

SqlInstance и databaseName подходят только для использования при добавлении учетной записи в базы данных перед настройкой уровня приложений. Это в первую очередь полезно в сценариях аварийного восстановления, когда требуется другая учетная запись перед запуском мастера настройки только AT.

Параметр "Продолжить" используется при добавлении или изменении учетной записи. Для этих операций учетная запись изменяется в каждой базе данных коллекции. Если предоставлено продолжение, он будет продолжаться, если коллекция недоступна. Его можно запустить снова, когда они доступны.

Примечание.

Учетные записи должны находиться в формате domainName\userName. Для системных учетных записей необходимо использовать кавычки вокруг полного имени учетной записи (например, NT Authority\Network Service). Системные учетные записи не требуют пароля.

Параметр	Описание
Счет	Указывает имя учетной записи, которую требуется добавить, изменить или удалить из указанного типа учетной записи, например /AccountType:ApplicationTier.
Пароль	Указывает пароль учетной записи службы. Этот параметр необязателен, если вы используете системную учетную запись или учетную запись, которая не имеет пароля, например сетевая служба.
sqlInstance	Используется только с /ResetOwner. Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. Необходимо указать имя и экземпляр в следующем формате: ServerName\InstanceName.
имяБазыДанных	Используется только с /ResetOwner. Указывает имя базы данных, владение которой необходимо изменить. С помощью этой команды вы сбрасываете владение базой данных, указанной в учетной записи, в которой выполняется команда.
продолжать	Обновляет все группы, которые недоступны при выполнении команды. Этот параметр обычно используется в сценариях NLB.

Предпосылки

Чтобы использовать команду учетные записи, необходимо быть членом группы:

Группа безопасности Администраторов Azure DevOps
роль sysadmin для всех экземпляров SQL Server, которые использует экземпляр Azure DevOps Server.

Если вы используете параметр /proxy, необходимо быть администратором на прокси-сервере.

Дополнительные сведения см. в справочнике по разрешениям дляAzure DevOps Server.

Замечания

Используйте команду accounts для автоматизации изменений в учетных записях служб, базах данных и группах учетных записей служб Azure DevOps Server. Вы можете настроить уже созданные учетные записи, но нельзя создавать учетные записи.

Перед изменением домена или рабочей группы учетной записи необходимо, чтобы для нее было установлено разрешение "Учетная запись является конфиденциальной и не может быть делегирована" на сервере уровня приложения. Дополнительные сведения см. на этой странице на веб-сайте Майкрософт: включение делегированной проверки подлинности.

Команда учетных записей поддерживает локальные развертывания 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 доступна в TFS 2017.1 и более поздних версиях.

Вы используете команду addProjectReports для добавления или перезаписи отчетов для существующего командного проекта.

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

Вариант	Описание
коллекция	Обязательное. URL-адрес коллекции командных проектов.
командный проект	Обязательное. Указывает имя командного проекта.
шаблон	Обязательное. Указывает имя шаблона процесса. Доступные варианты: Agile, CMMI и Scrum.
сила	Необязательно. Указывает, что отчеты должны быть перезаписаны, если они уже существуют.

Предпосылки

Чтобы использовать команду addProjectReports, необходимо иметь разрешения для выполнения TFSConfig и для отправки отчетов в Reporting Service.

Замечания

Вы используете команду addProjectReports , если у проекта нет отчетов или вы хотите обновить отчеты, определенные для процесса.

Возможно, вам потребуется использовать следующую команду, когда:

Проект был создан на портале Azure DevOps, а не из Visual Studio
Проект был создан из Visual Studio, однако отчеты не были настроены в Azure DevOps Server.

Если вы хотите перезаписать отчеты в проекте с отчетами по умолчанию, так как вы обновили Azure DevOps Server и старые отчеты в проекте больше не совместимы, используйте параметр /force. Если у вас есть настраиваемые отчеты, перед этим создайте резервную копию.

Дополнительные сведения о добавлении отчетов в локальный сервер Azure DevOps см. в статье Добавление отчетов в проект.

Пример

В следующем примере показано, как добавить отчеты 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 Server.

/provider: { NTLM | Согласование }

Указывает поставщик проверки подлинности, который требуется настроить для веб-сайта.

NTLM: используйте протокол проверки подлинности NTML
Negotiate: Используйте протокол аутентификации "Negotiate" (Kerberos).

/siteType

Указывает веб-сайт (уровень приложения или прокси-сервер), сетевой протокол проверки подлинности которого требуется изменить. Уровень приложений — это значение по умолчанию.

Предпосылки

Чтобы использовать команду аутентификации, необходимо быть членом группы безопасности Azure DevOps Administrators и локальным администратором на сервере уровня приложения или прокси-сервере в зависимости от значения параметра siteType.

Замечания

Команда проверки подлинности используется администратором, который хочет изменить протокол сетевой проверки подлинности для одного или нескольких веб-сайтов, на которых используется Azure DevOps Server. Администратор выполняет эту команду на уровне приложений, чтобы обновить эти веб-сайты, требующие изменения в протоколе сетевой проверки подлинности. Команда изменяет свойство NTAuthenticationProviders в метабазе IIS.

Перед использованием команды аутентификации для изменения протокола аутентификации, можно выполнить команду с параметром /viewAll, чтобы просмотреть существующие настройки.

Пример

В следующем примере отображается текущее значение, назначенное для протокола проверки подлинности сети.

TFSConfig Authentication /viewAll

Сертификаты

Используйте команду сертификатов, чтобы изменить способ настройки сертификатов для аутентификации клиента в развертывании Azure DevOps Server, использующего протокол HTTPS, протокол защищённых сокетов (SSL) и сертификаты.

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

Вариант	Описание
машина	Указывает, что список сертификатов будет находиться в контексте локального компьютера вместо текущего контекста пользователя.
отключить	Указывает, что параметр сертификата проверки подлинности клиента будет отключен.
автовыбор	Указывает, что сертификат будет автоматически выбран из списка сертификатов. Окно "Управление сертификатами клиентов" не откроется.
noprompt	Указывает, что окно "Управление сертификатами клиентов" не открывается при выполнении команды "Сертификаты".
отпечатки больших пальцев	Указывает, что будет использоваться сертификат, соответствующий указанному отпечатку. Можно указать несколько сертификатов, разделив отдельные отпечатки с запятой.

Предпосылки

Чтобы использовать сертификаты команду, необходимо быть членом группы безопасности Azure DevOps Administrators и локальной группы администраторов на компьютере, с которого выполняется команда. Для получения дополнительной информации см. справочник по разрешениям для Azure DevOps Server .

Замечания

По умолчанию команда сертификатов автоматически выбирает сертификат клиента из списка сертификатов для текущего пользователя. Однако можно использовать параметры команды, чтобы указать определенный сертификат или сертификаты из текущего контекста пользователя или из контекста локального компьютера.

Перед использованием команды сертификатов необходимо сначала настроить серверы в развертывании Azure DevOps Server для использования сертификатов. См. для получения дополнительных сведений о настройке HTTPS с помощью протокола SSL для Azure DevOps Server.

Вы используете команду сертификатов для настройки сертификатов клиента, используемых развертыванием сервера Azure DevOps Server, настроенного для использования HTTPS/SSL и сертификатов. Если вы используете команду certificates без параметров, сертификат клиента будет автоматически выбран из текущего контекста пользователя, из которого выполняется команда.

Примеры

В следующем примере показано, как указать сертификат локального компьютера с отпечатком aa bb cc dd ee без запроса.

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

В следующем примере показано, как указать автоматический выбор сертификата клиента из текущего хранилища пользователей.

TfsConfig certificates /autoselect

ИзменитьIDСервера

Команда changeServerID изменяет идентификаторы GUID, связанные с базами данных для Azure DevOps Server. Идентификаторы GUID должны быть уникальными в развертывании Azure DevOps Server. Если несколько баз данных имеют один и тот же GUID, развертывание может стать неустойчивым или непригодным для использования. Вы можете изменить GUID базы данных конфигурации, идентификаторы GUID всех баз данных коллекции проектов в развертывании или и то, и другое.

Хотя эта команда обычно не используется в ежедневных операциях, эта команда может использоваться в следующих обстоятельствах:

Вы восстановили развертывание на новом оборудовании, старое развертывание по-прежнему работает, и вы хотите использовать оба развертывания. Этот сценарий иногда называется клонированием сервера.
Вы хотите протестировать обновление программного обеспечения или конфигурацию оборудования в повторяющихся развертываниях, чтобы не нарушить рабочую среду.
Вы хотите полностью протестировать восстановление баз данных на новом оборудовании в лаборатории тестирования или отдельной среде, чтобы обеспечить восстановление развертывания.
Необходимо сбросить GUID для базы данных коллекции после перемещения в другое развертывание, для которого этот GUID уже зарезервирован.

Примечание.

Команда changeServerID не является обратимой. После изменения GUID нельзя отменить это изменение, за исключением восстановления предыдущей версии этой базы данных.

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

Вариант	Описание
sqlInstance	Обязательное. Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат: `ServerName\InstanceName`.
имяБазыДанных	Обязательное. Указывает имя базы данных конфигурации для Azure DevOps Server. По умолчанию имя этой базы данных TFS_ConfigurationDB.
только коллекции проекта	Указывает, что будут изменены только идентификаторы GUID для коллекций.
configDBOnly	Указывается, что будет изменён только GUID для базы данных конфигурации.
Название коллекции	Указывает на создание нового идентификатора экземпляра для определенной коллекции, но не для экземпляра Azure DevOps и других коллекций.

Предпосылки

Чтобы использовать команду changeServerID, необходимо быть членом группы безопасности Azure DevOps Administrators и членом роли безопасности sysadmin для всех экземпляров SQL Server, используемых Azure DevOps Server. Дополнительные сведения см. в справочнике по разрешениям для Azure DevOps.

Замечания

Для тестирования или клонирования используется команда changeServerID для создания дискретного дубликата развертывания Azure DevOps Server. После использования команды changeServerID необходимо направить клиентов для создания подключения к измененному серверу, прежде чем его можно будет использовать.

Пример

В следующем примере показано, как изменить идентификаторы GUID всех баз данных в развертывании Contoso1 Azure DevOps Server, где база данных конфигурации размещается на сервере с именем ContosoMain на именованном экземпляре TeamDatabases в SQL Server.

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>]

Вариант	Описание
статус индексации	Отображение состояния и конфигурации службы индексирования кода.
установка индексации	в: начать индексирование всех наборов изменений. отключены: остановите индексирование всех наборов изменений. keepupOnly: остановите индексирование ранее созданных наборов изменений и начните индексировать только новые наборы изменений.
ignoreList	Указывает список файлов кода и их пути, которые не нужно индексировать. добавить: добавьте файл, который вы не хотите индексировать, в список игнорируемых файлов. удалить: удалите файл, который требуется индексировать из игнорируемого списка файлов. removeAll: очистить игнорируемый список файлов и начать индексировать все файлы. В виде: посмотрите все файлы, которые не индексируются. ServerPath: указывает путь к файлу кода. Можно использовать подстановочный знак (*) в начале, в конце или на обоих концах пути сервера.
Список больших файлов	Показывает указанное количество файлов, превышающее указанный размер в КБ. Затем можно использовать параметр /ignoreList, чтобы исключить эти файлы из индексирования. Для этого вам потребуется Team Foundation Server 2013 с обновлением 3.
перестроитьИндексы	Очистить ранее индексированные данные и перезапустить индексирование.
destroyCodeIndex	Удалите индекс кода и удалите все индексированные данные. Не требуется подтверждение, если используется параметр /noPrompt.
ОграничениеВременногоОбъемаДанных	Управление временными данными, создаваемыми CodeLens при обработке наборов изменений. Ограничение по умолчанию составляет 6 ГБ (2 ГБ в обновлении 5). вид: показать текущий предел размера. РазмерВГигабайтах: измените лимит размера. отключите: удалите ограничение размера. Это ограничение проверяется перед обработкой нового набора изменений CodeLens. Если временные данные превышают это ограничение, CodeLens приостанавливает обработку последних наборов изменений, а не новых. CodeLens возобновит обработку после того, как данные будут очищены и их размер упадет ниже этого предела. Очистка выполняется автоматически один раз в день. Это означает, что временные данные могут превышать это ограничение, пока не начнется очистка. Для этого потребуется Team Foundation Server 2013 с обновлением 4.
индексИсторическийПериод	Управляйте продолжительностью индексирования журнала изменений. Это влияет на то, сколько истории показывает вам CodeLens. Ограничение по умолчанию составляет 12 месяцев. Это означает, что CodeLens отображает журнал изменений только за последние 12 месяцев. вид: Показать текущее количество месяцев. все: индексировать всю историю изменений. NumberOfMonths: измените количество месяцев, используемых для индексирования истории изменений. Для этого потребуется Team Foundation Server 2013 с обновлением 4.
имяКоллекции	Указывает имя коллекции проектов, в которой выполняется команда CodeIndex. Обязательно, если вы не используете /CollectionId.
collectionId	Указывает идентификационный номер коллекции проектов, в которой выполняется команда CodeIndex. Обязательно, если вы не используете /CollectionName

Предпосылки

Чтобы использовать команду 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 КБ:

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]

Вариант	Описание
прикрепить	Требуется, если не используется ни /detach, ни /delete. Если этот параметр указан, необходимо также использовать параметр /collectionDB. В качестве параметра можно также использовать /collectionName и /clone с помощью этого параметра. Если вы используете параметр /attach, указанная база данных коллекции будет добавлена в ваше развертывание Azure DevOps Server.
создавать	Создает коллекцию.
отделять	Требуется, если не используется ни /attach, ни /delete. Если этот параметр указан, необходимо также использовать параметр /collectionName. Если вы используете параметр /detach, база данных для указанной коллекции будет остановлена, а коллекция будет отключена от развертывания Azure DevOps Server.
удалить	Требуется, если не используется ни /detach, ни /attach. Если этот параметр указан, необходимо также использовать параметр /collectionName. Если вы используете параметр /delete, база данных для указанной коллекции будет остановлена, а коллекция будет окончательно отсоединяться от Azure DevOps Server. Вы не сможете повторно подключить базу данных коллекции к этому или другому развертыванию.
НазваниеКоллекции	Указывает имя коллекции проектов. Если имя коллекции содержит пробелы, необходимо заключить имя в кавычки (например, "Моя коллекция"). Требуется, если используется /отсоединение или /удаление. Если вы используете этот параметр с /отсоединить или /удалить, он указывает коллекцию, которая будет отсоединена или удалена. Если этот параметр используется с /attach, он задает новое имя коллекции. Если этот параметр используется как с /attach, так и с /clone, он задает имя дублирующейся коллекции.
CollectionDB	Требуется, если используется /attach. Этот параметр указывает имя сервера, на котором выполняется SQL Server, и имя базы данных коллекции, размещенной на этом сервере.
Имя сервера	Указывает имя сервера, на котором размещена база данных конфигурации для Azure DevOps Server, и имя экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат: `ServerName\InstanceName`.
имя_базы_данных	Указывает имя базы данных конфигурации. По умолчанию имя этой базы данных TFS_ConfigurationDB.
клон	Если указать этот параметр, исходная база данных коллекции будет присоединена как клон в SQL Server, и эта база данных будет присоединена к Azure DevOps Server. Этот параметр в основном используется в рамках разделения коллекции проектов.

Подсказка

Параметр /delete не удаляет базу данных коллекции из SQL Server. После удаления базы данных коллекции из Azure DevOps Server можно удалить базу данных вручную из SQL Server.

Предпосылки

Чтобы использовать команду коллекций, необходимо быть членом группы безопасности Team Foundation Administrators, а также членом локальной группы администраторов на компьютере, на котором запущен TfsConfig. Кроме того, необходимо быть членом роли безопасности sysadmin для всех экземпляров SQL Server, используемых базами данных Azure DevOps Server. Если развертывание интегрировано с SharePoint и используется параметр /delete, вы также должны быть членом группы "Администраторы фермы" для фермы SharePoint, из которой удаляется семейство веб-сайтов.

Дополнительные сведения см. в справочнике по разрешениям дляAzure DevOps Server.

Замечания

Для интерактивного управления коллекциями или создания коллекции можно использовать узел "Коллекции проектов" в консоли администрирования для Azure DevOps. См. раздел Управление коллекциями проектов.

Примеры

В следующем примере показано, как окончательно удалить коллекцию проектов Contoso Summer Intern Projects из развертывания Azure DevOps Server.

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

Индекс столбцового хранилища

Примечание.

Доступность команд: требуется TFS 2015.2 и более поздних версий.

Вы используете команду columnStoreIndex для включения или отключения индексов хранилища столбцов для баз данных, используемых развертыванием Azure DevOps Server.

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

Вариант	Описание
Активирован	Указывает, включаете или отключаете индекс хранилища столбцов для данного экземпляра и базы данных SQL.
sqlInstance	Указывает имя сервера, на котором размещена база данных, для которой индекс хранилища столбцов включается или отключается, а также имя экземпляра, если используется экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат: `ServerName\InstanceName`.
имяБазыДанных	Указывает имя базы данных, для которой включен или отключен индекс хранилища столбцов.

Предпосылки

Чтобы использовать команду columnStoreIndex, необходимо быть членом роли sysadmin для указанного экземпляра SQL Server.

Замечания

Обычно вы используете команду columnStoreIndex, если вы перемещаете базу данных из экземпляра SQL, который поддерживает индекс хранилища столбцов, в экземпляр, который его не поддерживает. В этом случае необходимо отключить все индексы хранилища столбцов, прежде чем успешно переместить базы данных. Аналогичным образом, если база данных перемещается обратно в экземпляр SQL, который поддерживает индекс хранилища столбцов, можно повторно включить индекс хранилища столбцов для экономии места и повышения производительности.

Пример

В следующем примере показано, как включить индекс хранилища столбцов для базы данных с именем TFS_DefaultCollection на экземпляре SQL, работающем на сервере с именем ContosoMain в именованном экземпляре TeamDatabases.

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

Настроить почту

Настройте сервер, на котором запущен azure DevOps Server, для использования существующего SMTP-сервера для оповещений электронной почты.

TfsConfig configureMail /Enabled:<true|false> /FromEmailAddress:<emailAddress> /SmtpHost:<SMTPHostName>

Вариант	Описание
АдресЭлектроннойПочтыОтправителя	Указывает адрес, из которого отправляются уведомления по электронной почте из Azure DevOps Server для регистрации, рабочего элемента, назначенного вам, или других уведомлений. Этот адрес также проверяется на допустимость, и в зависимости от конфигурации сервера может потребоваться представить допустимую учетную запись электронной почты на почтовом сервере. Если адрес не существует или недействителен, используется адрес электронной почты по умолчанию.
SmtpHost	Указывает имя сервера, на котором размещен почтовый сервер.

Вариант

Описание

АдресЭлектроннойПочтыОтправителя

Указывает адрес, из которого отправляются уведомления по электронной почте из Azure DevOps Server для регистрации, рабочего элемента, назначенного вам, или других уведомлений. Этот адрес также проверяется на допустимость, и в зависимости от конфигурации сервера может потребоваться представить допустимую учетную запись электронной почты на почтовом сервере. Если адрес не существует или недействителен, используется адрес электронной почты по умолчанию.

SmtpHost

Указывает имя сервера, на котором размещен почтовый сервер.

Предпосылки

Чтобы использовать команду configureMail, необходимо быть членом группы безопасности администраторов Team Foundation на сервере уровня приложений Azure DevOps. Дополнительные сведения см. в справочнике по разрешениям для Azure DevOps Server

Замечания

Вы также можете использовать консоль администрирования для настройки Azure DevOps Server для использования SMTP-сервера.

Пример

В следующем примере показан синтаксис, используемый для настройки адреса отправителя электронной почты на TFS@contoso.com и настройки почтового сервера SMTP на ContosoMailServer.

TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer

Сжатие БД

Вы используете команду dbCompression для включения или отключения сжатия страниц базы данных для баз данных, используемых развертыванием Azure DevOps Server.

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

Вариант	Описание
сжатие страниц	Указывает, включаете или отключаете сжатие страниц для данного экземпляра и базы данных SQL.
sqlInstance	Указывает имя сервера, на котором размещается база данных, для которой включено или отключено сжатие страниц, а также имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. Если указать экземпляр, необходимо использовать формат: `ServerName\InstanceName`
названиеБазыДанных	Указывает имя базы данных, для которой включено или отключено сжатие страниц.
перестроитьСейчас	Необязательно. Указывает, следует ли немедленно перестроить индексы базы данных (и сжать или распаковать их при необходимости). Если индексы не используются, они будут перестроены фоновым процессом, который выполняется еженедельно.
оффлайн	Необязательно. Используется только в сочетании с /rebuildNow. Если /не в сети не указан, индексы будут перестроены онлайн. Если задан /offline, индексы будут перестроены автономно. Это приведет к блокированию других операций, но может быть быстрее, чем перестроение индекса в сети.

Предпосылки

Чтобы использовать команду dbCompression, необходимо быть членом роли sysadmin для указанного экземпляра SQL Server.

Замечания

Обычно команда dbCompression используется, если вы перемещаете базу данных из экземпляра SQL, который поддерживал сжатие, в экземпляр, который его не поддерживает. В этом случае необходимо отключить сжатие и распаковать все индексы, прежде чем успешно переместить базы данных. Аналогичным образом, если база данных перемещается обратно в экземпляр 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]

Вариант	Описание
ageInDays	Результаты тестов, которым больше указанного числа дней, будут удалены или представлены для просмотра.
sqlInstance	Имя сервера, на котором размещается база данных, для которой удаляются результаты теста или просматриваются, и имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. При указании экземпляра необходимо использовать формат: `ServerName\InstanceName`.
имяБазыДанных	Имя базы данных, для которой удаляют или просматривают результаты теста.
тип	Необязательно. Тип результатов теста для удаления. Допустимые значения: автоматизированное, ручное управлениеи все.
предварительный просмотр	Необязательно. Отобразите количество результатов теста, которые должны быть удалены в зависимости от возраста в днях, но не удаляйте эти результаты.

Предпосылки

Чтобы использовать команду deleteTestResults, необходимо быть членом роли sysadmin для указанного экземпляра SQL Server.

Замечания

Используйте параметр /preview, чтобы просмотреть результаты теста, отсортированные по имени проекта и году без удаления этих результатов.

Пример

В следующем примере показано, как удалить результаты теста вручную старше 60 дней для базы данных с именем TFS_DefaultCollection на экземпляре SQL, работающем на сервере с именем ContosoMain в именованном экземпляре TeamDatabases.

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

DeploymentPool

Команда deploymentPool предназначена для переноса всех групп развертывания из одного пула развертывания в другой.

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

Вариант	Описание
fromPool	Имя исходного пула.
toPool	Имя целевого пула.

Удостоверения

Команда identities перечисляет или изменяет идентификатор безопасности (SID) пользователей и групп в вашем развертывании Azure DevOps Server. Возможно, потребуется изменить или обновить идентификатор безопасности для пользователей и групп в одном из следующих сценариев:

Изменение домена развертывания
Переход с рабочей группы на домен или из домена в рабочую группу
Перенос учетных записей между доменами в Active Directory

Примечание.

Эта команда не требуется выполнять, если вы изменяете домены в одном лесу Active Directory. Azure DevOps Server автоматически обрабатывает изменения идентификатора безопасности (SID) для перемещений в пределах одного леса.

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

Вариант	Описание
изменение	Указывает, что вы хотите изменить идентификации, а не перечислять их.
fromdomain	Требуется при использовании /change. Указывает оригинальный домен идентификаторов, которые вы хотите изменить. При изменении среды рабочей группы укажите имя компьютера.
todomain	Требуется при использовании /изменить. Указывает домен, на который вы хотите изменить идентификаторы. Если вы изменяете среду рабочей группы, укажите имя компьютера.
аккаунт	Указывает имя учетной записи, для которой вы хотите перечислить или изменить удостоверения.
toaccount	Указывает имя учетной записи, на которую вы хотите изменить идентичность.
SQLInstance	Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. Если указать экземпляр, необходимо использовать следующий формат: ИмяСервера\ИмяЭкземпляра
имя_базы_данных	Указывает имя базы данных конфигурации для Azure DevOps Server.

Предпосылки

Чтобы использовать команду удостоверений, необходимо быть членом группы безопасности администраторов Team Foundation и членом роли sysadmin для всех экземпляров SQL Server, используемых Team Foundation Server. Дополнительные сведения см. в разделе Настройка разрешений администратора дляAzure DevOps Server.

Замечания

При необходимости можно указать базу данных для изменения удостоверений перед настройкой сервера уровня приложений для развертывания. Например, можно указать базу данных, чтобы изменить учетную запись службы при клонировании развертывания Azure DevOps Server.

При изменении идентификаций целевая учетная запись или учетные записи должны уже существовать в Windows.

Свойства учетных записей, изменяемых с помощью этой команды, будут обновлены только после следующей синхронизации удостоверений с Windows. Это требование включает изменения из группы в пользователя, из пользователя в группу, а также из учетной записи домена в локальную учетную запись.

Примеры

В следующем примере показано, как вывести список имен всех пользователей и групп Windows, хранящихся в Azure DevOps Server, и определить, соответствует ли идентификатор безопасности для каждого пользователя или группы безопасности в Windows. Администраторы домена 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.

В следующем примере показано, как изменить идентификаторы SID для всех учетных записей в Azure DevOps Server из домена Contoso1 на идентификаторы SID для учетных записей, которые имеют соответствующие имена в домене ContosoPrime. Только для совпадающих имен учетных записей будут обновлены их идентификаторы безопасности. Например, если учетная запись hholt существует как Contoso1\hholt и ContosoPrime\hholt, идентификатор безопасности учетной записи будет изменен на идентификатор безопасности для ContosoPrime\hholt. Если учетная запись ContosoPrime\hholt не существует, идентификатор безопасности не будет обновлен для Contoso1\hholt.

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, которая используется в развертывании Azure DevOps Server при изменении домена развертывания с Contoso1 на ContosoPrime. Чтобы изменить системную учетную запись, например сетевую службу, необходимо выполнить двухэтапный процесс. Сначала вы измените учетную запись службы с NT AUTHORITY\NETWORK SERVICE на учетную запись домена в новом домене TempSVC, а затем измените учетную запись обратно на NETWORK SERVICE на сервере в новом домене. База данных конфигурации размещается на сервере, который называется ContosoMain на именованном экземпляре TeamDatabases в SQL Server.

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>]

Вариант	Описание
снова пробовать	Требуется, если /dumplog не используется. Указывает, что последнее задание будет повторно выполнено для указанной коллекции проектов. При использовании этого параметра необходимо также использовать параметр /CollectionName или параметр /CollectionID.
дамплог	Требуется, если /retry не используется. Указывает, что последнее действие задания для коллекции будет отправлено в файл журнала. При использовании этого параметра необходимо также использовать параметр /CollectionName или /CollectionID.
НазваниеКоллекции	Требуется, если /CollectionID не используется. Указывает имя коллекции, для которой наиболее недавняя задача будет либо повторно выполнена (/retry), либо записана в журнал (/dumplog). Если вы хотите указать все коллекции, можно использовать звездочку (*).
Идентификатор коллекции	Требуется, если /CollectionName не используется. Указывает идентификационный номер коллекции, для которой последнее выполненное задание будет перезапущено (/retry) или зафиксировано (/dumplog).

Предпосылки

Чтобы использовать команду заданий , необходимо быть членом группы безопасности администраторов Azure DevOps. Дополнительные сведения см. в справочнике по разрешениям дляAzure DevOps Server.

Замечания

Чтобы повторно выполнить задание в интерактивном режиме, откройте консоль администрирования Azure DevOps, перейдите на вкладку "Статус" для коллекции, а затем выберите Повторить задание. Дополнительные сведения смотрите в разделе "Открытие Консоли Администрирования Azure DevOps".

Пример

В следующем примере показано, как создать файл журнала, который содержит последние действия задания для коллекции проектов Contoso Summer Intern Projects в Azure DevOps Server.

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

Отключение от сети

Вы используете команду offlineDetach для преобразования автономной базы данных коллекции в отключенную автономную базу данных коллекции.

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

Вариант	Описание
КонфигурацияБД	Указывает имя используемой базы данных конфигурации.
collectionDB	Указывает имя отсоединяемой базы данных коллекции.

Предпосылки

Чтобы использовать команду offlineDetach, необходимо быть членом роли sysadmin для указанного экземпляра SQL Server.

Замечания

Эта команда изменяет схему указанной базы данных коллекции и никогда не должна выполняться в базах данных, которые используются развертыванием Team Foundation Server. Если базы данных используются в развертывании Team Foundation Server, вместо этого используйте TfsConfig collection /detach.

Эта команда полезна, если необходимо восстановить отдельную базу данных коллекции из резервной копии, не восстанавливая другие базы данных коллекции, которые являются частью того же развертывания Azure DevOps Server. Ранее это потребовало восстановления полного и согласованного набора баз данных (конфигурации и всех коллекций) в промежуточной среде, настройке развертывания Azure DevOps Server с помощью этих баз данных и отсоединении одной коллекции интересов.

Вместо этого можно восстановить последовательные копии базы данных конфигурации и базы данных коллекции, интересующей вас, и запустить команду offlineDetach. После этого отсоединяемая база данных коллекции может быть присоединена к любому развертыванию Azure DevOps Server в соответствующей версии.

Пример

В следующем примере показано отключение базы данных коллекции с именем TFS_PrimaryCollectionс использованием базы данных конфигурации с именем TFS_Configuration, при этом обе базы данных находятся в экземпляре SQL, работающем на сервере с именем ContosoTemp на именованном экземпляре Backups.

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]

Вариант	Описание
добавить	Добавляет указанный сервер или коллекцию в список прокси-сервера в файле Proxy.config. Вы можете запустить /добавить несколько раз, чтобы включить дополнительные коллекции или серверы. При использовании /add с коллекцией, размещенной в Azure DevOps Services, вам будет предложено предоставить учетные данные в Azure DevOps Services.
изменение	Изменяет учетные данные, хранящиеся в качестве учетной записи службы для Azure DevOps Services. Параметр /change используется только для Azure DevOps Services; Его не следует использовать для локальных развертываний Azure DevOps Server.
удалить	Удаляет указанный сервер или коллекцию из списка прокси-сервера в файле Proxy.config.
аккаунт	Указывает учетную запись, используемую в качестве учетной записи службы для прокси-сервера в Azure DevOps Services. Этот параметр используется только для Azure DevOps Services вместе с параметром /change. Учетная запись службы по умолчанию, используемая для Azure DevOps Services, — "Служба учетной записи".
продолжать	Продолжает выполнение команды, даже если процесс проверки выдает предупреждения.
Коллекция	Указывает URL-адрес коллекции проектов, размещенной в Azure DevOps Services, в формате `AccountName.DomainName/CollectionName`.
аккаунт	Указывает имя учетной записи, которая используется в качестве учетной записи службы для Azure DevOps Services. Если имя учетной записи имеет пробелы, имя должно быть заключено в кавычки (""). Все специальные символы в именах учетных записей должны быть указаны в соответствии с синтаксисом командной строки.
аккаунт	Указывает URL-адрес развертывания Azure DevOps Server в `ServerURL:Port/tfs` формате.
Файл личного токена доступа (PersonalAccessTokenFile)	При необходимости указывает путь к файлу, содержаму личный маркер доступа. Этот токен будет использоваться для аутентификации в коллекции или учетной записи при регистрации прокси-сервера. (Добавлено в TFS 2018, пакет обновления 1)
Входы	Необязательно. Указывает дополнительные параметры и значения, которые следует использовать при настройке прокси-сервера.! Например, значения для `GvfsProjectName` и `GvfsRepositoryName` можно использовать для настройки репозитория Git для использования с виртуальной файловой системой Git (GVFS) (добавлено в TFS 2018 с обновлением 1)

Предпосылки

Чтобы использовать команду прокси-сервера, необходимо быть членом группы безопасности Azure DevOps Administrators и администратором прокси-сервера. Дополнительные сведения см. в справочнике по разрешениям для Azure DevOps Server.

Замечания

Для обновления существующей конфигурации прокси-сервера Azure DevOps Server используйте команду . Для первоначальной установки и настройки прокси-сервера нельзя использовать команду прокси-сервера.

Примеры

В следующем примере показано, как добавить развертывание Azure DevOps Server с именем FABRIKAM в список прокси-серверов.

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

В следующем примере показано, как добавить коллекцию проектов, размещенную в Azure DevOps Services, в список прокси-серверов с помощью личного маркера доступа для аутентификации. Этот маркер будет использоваться только для регистрации прокси-сервера в учетной записи Azure DevOps Services. Учетная запись службы по умолчанию по-прежнему будет использоваться для запуска прокси-сервера. Этот параметр был добавлен в TFS 2018 с обновлением 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"

В следующем примере показано, как добавить репозиторий Git для использования с GVFS.

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

Перестроение склада

Вы можете использовать команду rebuildWarehouse для перестроения баз данных служб SQL Server Reporting Services и SQL Server Analysis Services, используемых Azure DevOps Server.

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

Вариант	Описание
analysisServices	Требуется, если /all не используется. Указывает, что будет перестроена только база данных для служб Analysis Services. Если база данных не существует для служб Analysis Services, необходимо также использовать параметр /reportingDataSourcePassword.
все	Требуется, если /analysisServices не используется. Указывает, что все базы данных отчетов и анализа, используемые Azure DevOps Server, будут перестроены.
reporting_Источник_Данных_Пароль	Требуется, если база данных TFS_Analysis не существует. Указывает пароль учетной записи, которая используется в качестве учетной записи источников данных для служб SQL Server Reporting Services (TFSReports). Дополнительные сведения см. в учетные записи служб и их зависимости в Azure DevOps Server.

Предпосылки

Чтобы использовать команду rebuildWarehouse, необходимо быть членом следующих групп:

Группа безопасности "Администраторы Azure DevOps" и группа безопасности администраторов на сервере или серверах, где запущена консоль администрирования Azure DevOps.
Группа sysadmin на сервере или серверах под управлением экземпляра SQL Server, на котором размещены базы данных для Azure DevOps Server

Дополнительные сведения см. в справочнике по разрешениям для 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

Используйте registerDB для обновления имени сервера, на котором размещена база данных конфигурации в Azure DevOps Server. Эту команду можно использовать при восстановлении базы данных конфигурации на новом оборудовании или при изменении домена развертывания.

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

Вариант Описание

SQLInstance Обязательное. Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName.

имяБазыДанных Обязательное. Указывает имя базы данных конфигурации. По умолчанию это Tfs_Configuration.

Вариант	Описание
SQLInstance	Обязательное. Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат: `ServerName\InstanceName`.
имяБазыДанных	Обязательное. Указывает имя базы данных конфигурации. По умолчанию это Tfs_Configuration.

Предпосылки

Чтобы использовать команду registerDB, необходимо быть членом группы администраторов Azure DevOps на сервере уровня приложений для Azure DevOps и членом группы sysadmin в SQL Server на сервере уровня данных для Azure DevOps. Для получения дополнительной информации см. справочник по разрешениям для Azure DevOps Server.

Замечания

Создайте резервную копию баз данных для Azure DevOps Server перед использованием этой команды.

Чтобы команда registerDB успешно выполнена, должны выполняться следующие пулы приложений и программы:

Пул приложений Azure DevOps Server (пул приложений)
ReportServer (пул приложений)
СЛУЖБЫ SQL Server Reporting Services (программа)

Для правильной работы этой команды необходимо указать точное имя или адрес базы данных конфигурации. Если необходимо изменить сервер, на котором хранится эта база данных, необходимо убедиться, что Azure DevOps Server указывает на новое расположение.

Пример

В следующем примере azure DevOps Server перенаправляется в базу данных конфигурации, расположенную на сервере ContosoMain экземпляра SQL Server TeamDatabases.

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

RemapDBs

Команда 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]

Вариант	Описание
имя_базы_данных	Указывает имя сервера, на котором размещается база данных, которую требуется сопоставить с Azure DevOps Server, помимо имени самой базы данных.
SQLInstances	Указывает имя сервера, на котором выполняется SQL Server, в дополнение к имени экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. При указании нескольких серверов необходимо использовать запятую для разделения нескольких пар имен серверов и экземпляров.
ЭкземплярАнализа	Необязательно. Указывает имя сервера и экземпляра, на котором размещаются службы SQL Server Analysis Services. Используйте этот параметр, чтобы указать сервер и экземпляр, на которых находится база данных Analysis Services.
ИмяБазыДанныхАнализа	Необязательно. Указывает имя базы данных Служб Analysis Services, которую вы хотите использовать с Azure DevOps Server, если на сервере, указанному с параметром /AnalysisInstance, используется несколько таких баз данных.
предварительный просмотр	Необязательно. Отображает действия, которые необходимо предпринять для обновления конфигурации.
продолжать	Необязательно. Указывает, что команда RemapDB должна продолжаться, даже если возникает ошибка при попытке найти одну или несколько баз данных. Если вы используете параметр /continue, все коллекции, базы данных которых не найдены на сервере или серверах, указанных вами, будут перенастроены для использования сервера и экземпляра, на котором размещена база данных конфигурации.

Предпосылки

Чтобы использовать команду remapDBs, необходимо быть членом группы безопасности Azure DevOps Administrators и членом группы безопасности sysadmin для всех баз данных SQL Server, используемых Azure DevOps Server. Дополнительные сведения см. в справочнике по разрешениям дляAzure DevOps Server.

Замечания

Для перенастройки Azure DevOps Server для использования других серверов и экземпляров SQL Server вместо серверов и экземпляров в первоначальной установке используется команда remapDBs.

Пример

В следующем примере показано, как перенаправить 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. Кроме того, необходимо быть членом роли безопасности sysadmin для всех экземпляров SQL Server, используемых развертыванием Azure DevOps Server.

Замечания

Обычно вы используете команду repairJobQueue, если вы заметили, что запланированные задания не выполняются.
Команда не принимает никаких аргументов и требует настройки развертывания Azure DevOps Server.

Пример

TfsConfig repairJobQueue

Настройки

Вы можете использовать параметры для автоматизации изменений в универсальном указателе ресурсов (URL-адрес), который используется интерфейсом уведомлений и адресом сервера для Azure DevOps Server. По умолчанию URL-адрес интерфейса уведомлений и URL-адрес сервера совпадают в Azure DevOps Server, но можно настроить отдельные URL-адреса. Например, может потребоваться использовать другой URL-адрес для автоматических сообщений электронной почты, создаваемых Azure DevOps Server. Это средство необходимо запустить на уровне приложений, чтобы обновить все серверы, чтобы они использовали новые URL-адреса.

Чтобы изменить эти URL-адреса в интерактивном режиме или просто просмотреть текущие параметры, можно использовать консоль администрирования для Azure DevOps. См. краткий справочник по административных задач.

TfsConfig settings [/publicURL:URL]

Вариант	Описание
publicUrl	Указывает URL-адрес сервера уровня приложения для Azure DevOps. Это значение хранится в базе данных конфигурации для Azure DevOps.

Предпосылки

Вы должны быть членом группы безопасности Azure DevOps Administrators и группы "Администраторы" на сервере уровня приложений. Дополнительные сведения см. в разделе Настройка разрешений администратора дляAzure DevOps Server.

Замечания

Команда изменяет сведения о подключении для связи между серверами в развертывании Azure DevOps Server. URL-адрес, указанный в /publicURL, должен быть доступен всем серверам в развертывании.

Пример

В следующем примере значение NotificationURL изменяется на http://contoso.example.com/tfs и значение ServerURL на http://contoso.example.com:8080/tfs.

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

Настройка

Для удаления компонентов, настроенных на компьютере, на котором выполняется команда , используется команда установки.

TfsConfig setup /uninstall:<feature[,feature,...]>

Параметр

Описание

/удалить

Указывает одну или несколько функций, которые необходимо удалить с компьютера, на котором выполняется команда. Варианты: All, ApplicationTier, Search и VersionControlProxy.

Предпосылки

Чтобы использовать команду установки, необходимо быть членом группы безопасности Azure DevOps Administrators.

Примеры

В следующем примере удаляются все функции Azure DevOps Server с текущего компьютера.

TfsConfig setup /uninstall:All

В следующем примере удаляется уровень приложений и функции сборки с текущего компьютера.

TfsConfig setup /uninstall:ApplicationTier

TCM

При обновлении до последней версии Azure DevOps Server система автоматически пытается обновить компоненты управления тестами, включая планы тестирования и наборы.

Если автоматическая миграция завершается ошибкой, используйте команду TCM для обновления планов тестирования и наборов тестов вручную до соответствующих типов рабочих элементов (WITs).

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

Параметр

Описание

/upgradeTestPlans

Требуется, если не используется /upgradeStatus.

Преобразует существующий план тестирования и наборы тестов, чтобы указать на планы тестирования на основе рабочих элементов и наборы тестов. Он также обновляет существующие данные управления тестами и связи между другими существующими артефактами теста, такими как точки тестирования, тестовые запуски и результаты теста.

/статус обновления

Требуется, если не используется /upgradeTestPlans.

Сообщает состояние миграции тестовых данных для указанного проекта. Он также указывает, имеет ли указанный проект какие-либо тестовые планы.

/CollectionName:CollectionName

Обязательное. Указывает коллекцию проектов, содержащую проект, для которого требуется перенести тестовые данные или проверить состояние миграции.

Если в имени коллекции проектов есть пробелы, заключите имя в кавычки, например "Fabrikam Fibre Collection".

/TeamProjectName:TeamProjectName

Обязательное. Указывает проект, для которого требуется перенести тестовые данные или проверить состояние миграции. Этот проект должен быть определен в коллекции, указанной с помощью параметра /collectionName.

Если в имени проекта есть пробелы, заключите имя в кавычки, например "Мой проект".

Предпосылки

Вы должны быть членом группы безопасности Team Foundation Administrators и администратором на сервере уровня приложений.

См. Установите разрешения администратора для Azure DevOps Server.

Замечания

Чтобы использовать эту команду, необходимо обновить сервер уровня приложений до последней версии Azure DevOps Server 2019.

Прежде чем использовать команду TCM, необходимо сначала импортировать определение рабочего элемента плана тестирования и категорию тестового плана в проект.

Дополнительные сведения о миграции и использовании этой команды см. в обновления вручную для поддержки управления тестами.

Команда TCM применяется к отдельным проектам. Если вам нужно обновить тестовые планы в нескольких проектах, вам придется запустить его для каждого проекта по отдельности.

Необходимо выполнить команду TCM из каталога средств для Azure DevOps Server. По умолчанию это расположение: drive:\%programfiles%\TFS 12.0\Tools.

Вы используете команду TCM только в случае сбоя автоматической миграции существующих тестовых данных.

Дополнительные сведения о миграции и использовании этой команды обновления вручную для поддержки управления тестами. Если вы не можете получить доступ к планам тестирования или наборам тестов, которые были определены до обновления сервера, выполните TFSConfig TCM upgradeStatus, чтобы определить состояние миграции.

Вы запускаете команду TCM для отдельного проекта. Если вам нужно обновить несколько проектов, вам потребуется запустить его в каждом проекте по очереди.

Примеры

В следующем примере показано, как проверить состояние обновления плана тестирования в проекте Fabrikam Fibre, размещенном в коллекции проектов по умолчанию (DefaultCollection):

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

Автоматическая автоматическая отмена

Доступность команд для Azure DevOps Server 2019

Команда автоматического предназначена для пользователей, знакомых с Azure DevOps Server и процессом настройки, а также для установки Azure DevOps Server на разных компьютерах.

Например, если вы используете Azure DevOps Build, вы можете использовать команду unattend для установки нескольких серверов сборки с помощью одного файла конфигурации.

Используйте параметр /create для создания автоматического файла. Этот файл определяет все параметры конфигурации для установки Azure DevOps Server. Затем используйте параметр /configure для фактической настройки.

Этот процесс позволяет настроить Azure DevOps Server от начала до завершения, не предоставляя входные данные во время установки. В случае нескольких установок это также помогает гарантировать, что одинаковые параметры конфигурации используются на нескольких серверах.

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

Вариант	Описание
создавать	Создает автоматический файл с указанным именем и параметрами.
настроить	Настраивает Azure DevOps Server с помощью автоматического файла и заданных параметров. Для этого параметра необходимо использовать /type или /unattendfile.
тип	Указывает тип используемой конфигурации. При использовании /configure требуется либо /type, либо /unattendfile, но их нельзя использовать.
unattendfile	Указывает автоматический файл для создания или использования в зависимости от того, является ли начальный параметр /create или /configure. При использовании /configure необходимо наличие /unattendfile или наличие /type.
Входы	Необязательно. При использовании /create указывает параметры и значения, используемые при создании файла автоматической установки. При использовании /configure для задания дополнительных параметров и значений в сочетании с файлом автоматической установки. В качестве альтернативы использованию /inputs, можно вручную изменить файл автоматической установки в любом текстовом редакторе. Это необходимо для определенных типов входных данных, таких как ServiceAccountPassword или PersonalAccessToken, так как эти значения секретов нельзя задать с помощью параметра /inputs.
проверить	Необязательно. Указывает запуск конфигурации, который выполняет проверки, основанные исключительно на файле ответов, входных данных и типе конфигурации. Это альтернатива выполнению полной конфигурации.
продолжать	Необязательно. Указывает, что /create или /configure должны продолжаться независимо от предупреждений от проверок.

Тип установки	Описание
NewServerBasic	Настраивает основные службы разработки для Azure DevOps Server. К ним относятся управление исходным кодом, рабочие элементы, сборка и, по желанию, поиск.
NewServerAdvanced	Настраивает основные службы разработки и разрешает необязательную настройку интеграции со службами Reporting Services.
Обновление	Обновляет Azure DevOps Server до текущей версии из поддерживаемого предыдущего выпуска.
PreProductionUpgrade	Проверьте обновление существующего развертывания Azure DevOps Server в предварительной рабочей среде. Обычно это делается с помощью баз данных, восстановленных из рабочих резервных копий. Этот сценарий включает дополнительные шаги, чтобы гарантировать, что новое развертывание не будет препятствовать рабочему развертыванию.
ApplicationTierOnlyBasic	Настройте новый уровень приложений с помощью существующих параметров из предоставленной базы данных конфигурации. Этот параметр позволяет быстро запустить новый уровень приложений и приступить к работе, используя существующие настройки. Если вы хотите изменить существующие параметры, используйте вместо этого тип Advanced ApplicationTierOnlyAdvanced.
УровеньПриложенияТолькоРасширенный	Настройте новый уровень приложений с полным контролем над всеми параметрами. Параметры по умолчанию будут использовать существующие значения из предоставленной базы данных конфигурации. Если вы хотите сохранить все существующие параметры, используйте вместо этого тип ApplicationTierOnlyBasic.
Клон	Настройте новое развертывание Azure DevOps Server, которое является клоном существующего развертывания. Обычно это делается с помощью баз данных, восстановленных из рабочих резервных копий, для создания среды, в которой можно протестировать изменения конфигурации, расширения и другие изменения. Этот сценарий включает дополнительные шаги, чтобы гарантировать, что новое развертывание не будет препятствовать рабочему развертыванию.
Прокси	Настраивает прокси-службу управления версиями.

Предпосылки

Вы должны быть членом группы "Администраторы" на компьютере, на котором устанавливается программное обеспечение.
В зависимости от типа установки также могут потребоваться дополнительные разрешения администратора.

Например, если вы используете команду автоматического для установки Azure DevOps Server, необходимо быть членом группы sysadmin на экземпляре SQL Server, который будет поддерживать Azure DevOps Server. Дополнительные сведения см. в разделе Q & A Добавление администраторов уровня сервера вAzure DevOps Server.

Замечания

Прежде чем использовать команду unattend для настройки Azure DevOps Server, необходимо создать учетные записи службы, которые будут использоваться в процессе развертывания. Необходимо также установить любое необходимое программное обеспечение для выбранного типа установки. Это включает в себя azure DevOps Server. Необходимо установить Azure DevOps Server, но вам не нужно настраивать его, так как команда без участия пользователя выполнит эту задачу.

Команда unattend настраивает компоненты Azure DevOps Server. Он не выполняет начальную установку программного обеспечения. Он настраивает программное обеспечение в соответствии с вашими спецификациями после того, как биты присутствуют на компьютере.

Примеры

В следующем примере показано, как создать автоматический файл для базовой установки Azure DevOps Server.

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

В этом примере файл ненадзираемого выполнения создается в том же каталоге, что и выполнение команды. Файл журнала создается в процессе команды, и расположение файла возвращается во время выполнения команды.

В следующем примере показано, как указать репозиторий Git для использования с GVFS во время настройки.

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

В следующем примере показано, как создать автоматический файл для настройки прокси-сервера Azure DevOps.

Это важно

В этом примере, если администраторы хотят использовать личный маркер доступа для проверки подлинности, необходимо вручную изменить файл, чтобы указать значение личного маркера доступа. Это можно сделать, добавив строку для личного токена доступа в созданный файл автоматической установки, например: PersonalAccessToken=PersonalAccessTokenValue.

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

В следующем примере показано, как создать файл автоматической установки для конфигурации сборки Azure DevOps Server на сервере, используя "FabrikamFiber\BuildSVC" в качестве учетной записи службы сборки, а затем настроить Azure DevOps Server Build с помощью этого файла автоматической установки.

Это важно

В этом примере после создания файла Unattend администратор вручную редактирует файл, чтобы указать пароль для учетной записи службы сборки. Добавление пароля в качестве входных данных с помощью ServiceAccountPassword=PasswordPlaceholder; не добавляет в файл сведения о пароле.

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 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

Команда ziplogs предназначена для сбора журналов и создания ZIP-файла в ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

Поделиться через

Использование TFSConfig для управления локальной средой Azure DevOps

Расположение средства командной строки

Предпосылки

Вывод списка команд и получение справки

Учетные записи

Предпосылки

Замечания

Примеры

ДобавитьОтчетыПроекта

Предпосылки

Замечания

Пример

Аутентификация

Предпосылки

Замечания

Пример

Сертификаты

Предпосылки

Замечания

Примеры

ИзменитьIDСервера

Предпосылки

Замечания

Пример

КодИндекс

Предпосылки

Примеры

Коллекция

Предпосылки

Замечания

Примеры

Индекс столбцового хранилища

Предпосылки

Замечания

Пример

Настроить почту

Предпосылки

Замечания

Пример

Сжатие БД

Предпосылки

Замечания

Пример

УдалитьРезультатыТеста

Предпосылки

Замечания

Пример

DeploymentPool

Удостоверения

Предпосылки

Замечания

Примеры

Вакансии

Предпосылки

Замечания

Пример

Отключение от сети

Предпосылки

Замечания

Пример

Прокси

Предпосылки

Замечания

Примеры

Перестроение склада

Предпосылки

Замечания

Пример

RegisterDB

Предпосылки

Замечания

Пример

RemapDBs

Предпосылки

Замечания

Пример

ОчередьЗадачПоРемонту

Предпосылки

Замечания