Использование TFSConfig для управления Azure DevOps в локальной среде
Azure DevOps Server 2022 г. | Azure DevOps Server 2020 г. | Azure DevOps Server 2019 г.
Вы можете использовать программу командной строки TFSConfig для выполнения различных административных действий для локального развертывания Azure DevOps.
TFSConfig можно запускать с любого компьютера, на котором установлена Azure DevOps Server.
Расположение программы командной строки
Программы командной строки 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
Чтобы получить справку по отдельной команде, используйте команду help и укажите имя команды, с которой требуется справка. Например, чтобы получить справку по команде accounts :
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]
| Операция | Описание |
|---|---|
| UpdatePassword | Изменяет пароль учетной записи, используемой в качестве учетной записи службы. Изменяет существующую учетную запись и все типы учетных записей, которые выполняются от имени данной учетной записи. |
| Изменение | Изменяет учетную запись, используемую в качестве учетной записи службы. Добавляет новую учетную запись в необходимые ресурсы и группы, предоставляет необходимые разрешения, а затем задает службу для ее использования. При этом старая учетная запись не удаляется из ресурсов. Если параметр accountType не используется, учетная запись службы для уровня приложений будет изменена. |
| Добавить | Добавляет только новую учетную запись в необходимые ресурсы. Полезно для сценариев балансировки сетевой нагрузки. Используйте флаг продолжения, если некоторые коллекции недоступны. Добавить можно выполнить позже, чтобы обновить все пропущенные коллекции. Добавляет учетную запись в группы, необходимые для использования учетной записи в качестве учетной записи службы. |
| Set | Устанавливает службу только для использования учетной записи, уже добавленной к ресурсам. Полезно для сценариев балансировки сетевой нагрузки. |
| Удалить | Удаляет учетную запись из всех ресурсов. При удалении учетной записи следует соблюдать меры предосторожности, так как это может привести к отказу в обслуживании других серверов. |
| ResetOwner | Если базы данных восстанавливаются в процессе перемещения, клонирования или аварийного восстановления, владелец базы данных может переключиться на администратора, восстанавливающего сервер. Этот параметр выполняет итерацию по всем базам данных и задает имя входа dbo текущему владельцу. |
| AccountType | Описание |
|---|---|
| AdminConsole | Пользователи консоли администрирования — это пользователи, которым предоставлены минимальные разрешения на использование консоли в различных ресурсах. |
| ApplicationTier | Изменяет учетную запись службы в appPool для основных веб-служб. (TFSService) |
| Proxy (Прокси) | Изменяет учетную запись службы в appPool для прокси-веб-служб. (TFSProxy) |
| ReportingDataSource | Изменяет учетную запись, используемую отчетами для доступа к данным отчетов. (TFSReports) |
Значение по умолчанию — ApplicationTier.
SqlInstance и databaseName подходят только при добавлении учетной записи в базы данных до настройки уровня приложения. Это в первую очередь полезно в сценариях аварийного восстановления, когда требуется другая учетная запись перед запуском мастера настройки только AT.
Параметр продолжить используется при добавлении или изменении учетной записи. Для этих операций учетная запись изменяется в каждой базе данных коллекции. Если указано значение continue, оно будет продолжаться, если коллекция недоступна. Его можно запустить снова, когда они доступны.
Примечание
Учетные записи должны иметь формат domainName\userName. Для системных учетных записей необходимо использовать кавычки для полного имени учетной записи (например, NT Authority\Network Service). Системные учетные записи не требуют пароля.
| Параметр | Описание |
|---|---|
| Учетная запись | Указывает имя учетной записи, которую вы хотите добавить, изменить или удалить из указанного типа учетной записи, например /AccountType:ApplicationTier. |
| Пароль | Указывает пароль учетной записи службы. Этот параметр является необязательным, если используется системная учетная запись или учетная запись без пароля, например сетевая служба. |
| sqlInstance | Используется только с параметром /ResetOwner. Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. Необходимо указать имя и экземпляр в следующем формате: Имя_сервера\Имя_экземпляра. |
| databaseName | Используется только с параметром /ResetOwner. Указывает имя базы данных, владение которой требуется изменить. С помощью этой команды вы сбрасываете права владения указанной базой данных для учетной записи, под которой выполняется команда. |
| continue | Обновления все группы, которые недоступны при выполнении команды. Этот параметр обычно используется в сценариях балансировки сетевой нагрузки. |
Предварительные требования
Чтобы использовать команду accounts , необходимо быть участником:
- группа безопасности Azure DevOps Administrators
- роль sysadmin для всех экземпляров SQL Server, которые использует экземпляр Azure DevOps Server.
При использовании параметра /proxy необходимо быть администратором прокси-сервера.
Дополнительные сведения см. в справочнике по разрешениям для Azure DevOps Server.
Комментарии
Используйте команду accounts, чтобы автоматизировать изменения учетных записей служб, баз данных и групп учетных записей служб Azure DevOps Server. Вы можете настроить уже созданные учетные записи, но не можете создавать учетные записи.
Перед изменением домена или рабочей группы учетной записи учетная запись должна иметь конфиденциальную учетную запись и не может быть делегирована разрешения на сервере уровня приложений. Дополнительные сведения см. на этой странице на веб-сайте Майкрософт: Включение делегированной проверки подлинности.
Команда accounts поддерживает локальные развертывания 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 базы данных на ContosoMain SQL Server в именованном TeamDatabases экземпляре на учетную запись пользователя, под которой выполняется команда.
Примечание
При использовании этой команды нельзя указать, какую учетную запись следует задать в качестве владельца баз данных. Владельцу будет присвоена учетная запись, под которой выполняется команда.
TfsConfig accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse
AddProjectReports
Примечание
Команда addProjectReports доступна в TFS 2017.1 и более поздних версиях.
Используйте команду addProjectReports , чтобы добавить или перезаписать отчеты для существующего командного проекта.
TfsConfig addProjectReports /collection:<teamProjectCollectionUrl> /teamProject:<projectName> /template:<templateName>
[/force]
| Параметр | Описание |
|---|---|
| коллекция | Обязательный. URL-адрес коллекции командных проектов. |
| проект команды | Обязательный. Указывает имя командного проекта. |
| шаблон | Обязательный. Указывает имя шаблона процесса. Доступные варианты: Agile, CMMI и Scrum. |
| 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
Аутентификация
Команда Authentication изменяет протокол проверки подлинности сети, используемый Azure DevOps Server уровня приложения или прокси-сайта.
TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]
Параметр
Описание
/viewAll
Отображает текущие параметры проверки подлинности для Azure DevOps Server.
/provider: { NTLM | Согласование }
Указывает поставщик проверки подлинности, который необходимо настроить для веб-сайта.
- NTLM: использование протокола проверки подлинности NTML
- Согласование: использование протокола проверки подлинности Negotiate (Kerberos)
/siteType
Указывает веб-сайт (уровень приложения или прокси-сервер), протокол сетевой проверки подлинности которого требуется изменить. По умолчанию используется уровень приложений.
Предварительные требования
Чтобы использовать команду Authentication , необходимо быть членом группы безопасности Администраторы Azure DevOps и локальным администратором на сервере уровня приложений или прокси-сервере в зависимости от значения параметра siteType .
Комментарии
Команда Authentication используется администратором, который хочет изменить протокол проверки подлинности сети для одного или нескольких веб-сайтов, на которых зависит Azure DevOps Server. Администратор выполняет эту команду на уровне приложений, чтобы обновить веб-сайты, для которых требуется изменить протокол проверки подлинности сети. Команда изменяет свойство NTAuthenticationProviders в метабазе IIS.
Перед использованием команды Authentication для изменения протокола проверки подлинности можно выполнить команду с параметром /viewAll , чтобы увидеть существующие параметры.
Пример
В следующем примере отображается текущее значение, присвоенное протоколу проверки подлинности сети.
TFSConfig Authentication /viewAll
Сертификаты
Используйте команду certificates, чтобы изменить способ настройки сертификатов для проверки подлинности клиента в развертывании Azure DevOps Server, использующее ПРОТОКОЛ HTTPS, протокол SSL и сертификаты.
TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]
| Параметр | Описание |
|---|---|
| компьютер | Указывает, что список сертификатов будет из контекста локального компьютера, а не из контекста текущего пользователя. |
| disable | Указывает, что параметр сертификата проверки подлинности клиента будет отключен. |
| autoSelect | Указывает, что сертификат будет автоматически выбран из списка сертификатов. Окно Управление сертификатами клиента не откроется. |
| noprompt | Указывает, что окно Управление сертификатами клиента не открывается при выполнении команды Сертификаты. |
| Отпечатки | Указывает, что будет использоваться сертификат, соответствующий указанному отпечатку. Можно указать несколько сертификатов, разделив отдельные отпечатки запятыми. |
Предварительные требования
Чтобы использовать команду certificates , необходимо быть членом группы безопасности Azure DevOps Administrators и локальной группы администраторов на компьютере, с которого выполняется команда. Дополнительные сведения см. в справочнике по разрешениям для Azure DevOps Server.
Комментарии
По умолчанию команда certificates автоматически выбирает сертификат клиента из списка сертификатов для текущего пользователя. Однако с помощью параметров команды можно указать конкретный сертификат или сертификаты из текущего контекста пользователя или из контекста локального компьютера.
Перед использованием команды certificates необходимо сначала настроить серверы в развертывании Azure DevOps Server для использования сертификатов. Дополнительные сведения см. в статье Настройка ПРОТОКОЛА HTTPS с протоколом SSL для Azure DevOps Server.
Команда certificates используется для настройки сертификатов клиента, используемых при развертывании Azure DevOps Server, настроенных для использования HTTPS/SSL и сертификатов. Если вы используете команду Сертификаты без параметров, сертификат клиента будет автоматически выбран из текущего контекста пользователя, из которого выполняется команда.
Примеры
В следующем примере показано, как указать сертификат локального компьютера с отпечатком aa bb cc dd ee без запроса.
TfsConfig certificates /machine /thumbprint:aa bb cc dd ee /noprompt
В следующем примере показано, как указать с помощью автоматического выбора сертификата клиента из текущего пользовательского хранилища.
TfsConfig certificates /autoselect
ChangeServerID
Команда 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. |
| databaseName | Обязательный. Указывает имя базы данных конфигурации для Azure DevOps Server. По умолчанию для этой базы данных используется имя TFS_ConfigurationDB. |
| projectCollectionsOnly | Указывает, что будут изменены только идентификаторы GUID для коллекций. |
| configDBOnly | Указывает, что будет изменен только GUID для базы данных конфигурации. |
| collectionName | Указывает, чтобы создать идентификатор экземпляра для конкретной коллекции, но не для экземпляра Azure DevOps и других коллекций. |
Предварительные требования
Чтобы использовать команду changeServerID, необходимо быть членом группы безопасности Администраторы Azure DevOps и членом роли безопасности 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
Используйте команду 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>]
| Параметр | Описание |
|---|---|
| indexingStatus | Отображает состояние и конфигурацию службы индексации кода. |
| setIndexing | on: запустить индексацию всех наборов изменений. off: остановить индексацию всех наборов изменений. keepupOnly: остановить индексацию созданных ранее наборов изменений и запустить индексацию только новых наборов изменений. |
| ignoreList | Определяет список файлов исходного кода и путей к ним, которые необходимо исключить из индексирования. add: добавить файл, который необходимо исключить из индексации, в список игнорируемых файлов. remove: удалить файл, который необходимо включить в индексацию, из списка игнорируемых файлов. removeAll: очистить список игнорируемых файлов и начать индексировать все файлы. view: просмотреть полный список файлов, которые не будут индексироваться. ServerPath: указывает путь к файлу кода. Можно использовать подстановочный знак (*) в начале, в конце, или на обоих концах серверного пути. |
| listLargeFiles | Просмотреть определенное количество файлов, размер которых превышает заданный размер в кБ. Можно воспользоваться параметром /ignoreList, чтобы исключить эти файлы из индексации. Для этого вам потребуется Team Foundation Server 2013 с обновлением 3. |
| reindexAll | Очистить ранее индексированные данные и перезапустить индексирование. |
| destroyCodeIndex | Удалить индекс кода и все индексированные данные. Не требует подтверждения, если используется параметр /noPrompt. |
| temporaryDataSizeLimit | Управляйте количеством временных данных, которые создает CodeLens при обработке наборов изменений. Ограничение по умолчанию — 6 ГБ (2 ГБ в обновлении 5). view: отображение текущего ограничения на размер. SizeInGBs: измените ограничение размера. disable: удаление ограничения на размер. Проверка этого ограничения выполняется перед тем, как CodeLens обрабатывает новый набор изменений. Если временные данные превышают данное ограничение, то CodeLens приостановит обработку ранних наборов изменений, но не новых. После того как данные будут очищены и их размер станет меньше указанного ограничения, элемент CodeLens перезапустит процесс обработки. Очистка выполняется автоматически раз в день. Это означает, что временные данные могут превысить ограничение перед выполнением очистки. Для этого вам потребуется Team Foundation Server 2013 с обновлением 4. |
| indexHistoryPeriod | Управляйте длительностью индексирования журнала изменений. Это влияет на объем отображаемого журнала CodeLens. Ограничение по умолчанию составляет 12 месяцев. Это означает, что CodeLens показывает журнал изменений только за последние 12 месяцев. view: отображение текущего количества месяцев. all: индексирование всего журнала изменений. NumberOfMonths: изменение количества месяцев, используемых для индексирования журнала изменений. Для этого вам потребуется Team Foundation Server 2013 с обновлением 4. |
| collectionName | Задает имя коллекции проектов, для которой необходимо выполнить команду CodeIndex. Является обязательным, если не используется параметр /CollectionId. |
| collectionId | Задает идентификационный номер коллекции проектов, для которой необходимо выполнить команду CodeIndex. Требуется, если вы не используете /CollectionName |
Предварительные требования
Чтобы использовать команду codeIndex , необходимо быть членом группы безопасности Администраторы Azure DevOps. См. справочник по разрешениям для 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"
Коллекция
Команду collection можно использовать для подключения, отсоединения или удаления коллекции проектов из развертывания Azure DevOps Server. Вы также можете использовать команду collection , чтобы дублировать базу данных существующей коллекции, переименовать ее и присоединить к развертыванию. Эта процедура иногда называется клонированием коллекции.
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. |
| create | Создает коллекцию. |
| detach | Требуется, если ни /attach , ни /delete не используются. При указании этого параметра необходимо также использовать параметр /collectionName . Если вы используете параметр /detach, база данных для указанной коллекции будет остановлена, а коллекция будет отключена от развертывания Azure DevOps Server. |
| удалить | Требуется, если ни /detach , ни /attach не используются. При указании этого параметра необходимо также использовать параметр /collectionName . При использовании параметра /delete база данных для указанной коллекции будет остановлена, а коллекция будет окончательно отключена от Azure DevOps Server. Вы не сможете повторно подключить базу данных коллекции к этому или любому другому развертыванию. |
| CollectionName | Задает имя коллекции проектов. Если имя коллекции содержит пробелы, необходимо заключить его в кавычки (например, «Моя коллекция»). Требуется, если используется параметр /detach или /delete . Если этот параметр используется с параметром /detach или /delete, он указывает коллекцию, которая будет отсоединяться или удаляться. Если этот параметр используется с параметром /attach, он задает новое имя коллекции. Если этот параметр используется как с /attach , так и с /clone, он указывает имя дублирующейся коллекции. |
| CollectionDB | Требуется, если используется параметр /attach . Этот параметр указывает имя сервера, на котором выполняется SQL Server, и имя базы данных коллекции, размещенной на этом сервере. |
| ServerName | Указывает имя сервера, на котором размещена база данных конфигурации для Azure DevOps Server, и имя экземпляра, если требуется использовать экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат : ServerName\InstanceName. |
| имя_базы_данных | Указывает имя базы данных конфигурации. По умолчанию для этой базы данных используется имя TFS_ConfigurationDB. |
| clone | Если указать этот параметр, исходная база данных коллекции будет присоединена как клон в SQL Server, и эта база данных будет присоединена к Azure DevOps Server. Этот параметр в основном используется в рамках разделения коллекции проектов. |
Совет
Параметр /delete не удаляет базу данных коллекции из SQL Server. После удаления базы данных коллекции из Azure DevOps Server ее можно удалить вручную из SQL Server.
Предварительные требования
Чтобы использовать команду collections , необходимо быть членом группы безопасности Администраторы Team Foundation, а также локальной группы администраторов на компьютере с 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
ColumnStoreIndex
Примечание
Доступность команд. Требуется TFS 2015.2 и более поздних версий.
Используйте команду columnStoreIndex, чтобы включить или отключить индексы хранилища столбцов для баз данных, используемых развертыванием Azure DevOps Server.
TfsConfig columnStoreIndex /enabled:<true|false>
/sqlInstance:<serverName>
/databaseName:<databaseName>
| Параметр | Описание |
|---|---|
| Включено | Указывает, включаете или отключаете индекс хранилища столбцов для данного экземпляра SQL и базы данных. |
| sqlInstance | Указывает имя сервера, на котором размещена база данных, для которого включен или отключен индекс хранилища столбцов, а также имя экземпляра, если используется экземпляр, отличный от стандартного. При указании экземпляра необходимо использовать формат : ServerName\InstanceName. |
| databaseName | Указывает имя базы данных, для которой включен или отключен индекс хранилища столбцов. |
Предварительные требования
Чтобы использовать команду columnStoreIndex, необходимо быть членом роли sysadmin для указанного экземпляра SQL Server.
Комментарии
Обычно команда columnStoreIndex используется при перемещении базы данных из экземпляра SQL, поддерживающего индекс хранилища столбцов, в базу данных, которая не выполняется. В этом случае необходимо отключить все индексы хранилища столбцов, прежде чем можно будет успешно переместить базы данных. Аналогичным образом, при перемещении базы данных обратно в экземпляр SQL, поддерживающий индекс хранилища столбцов, может потребоваться повторно включить индекс хранилища столбцов, чтобы сэкономить место и повысить производительность.
Пример
В следующем примере показано, как включить индекс хранилища столбцов для базы данных с именем TFS_DefaultCollection в экземпляре SQL, работающем на сервере ContosoMain на именованном экземпляре TeamDatabases.
TfsConfig columnStoreIndex /enabled:true /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection
ConfigureMail
Настройте сервер, на котором выполняется Azure DevOps Server, использовать существующий SMTP-сервер для оповещений по электронной почте.
TfsConfig configureMail /Enabled:<true|false> /FromEmailAddress:<emailAddress> /SmtpHost:<SMTPHostName>
| Параметр | Описание |
|---|---|
| FromEmailAddress | Указывает адрес, с которого отправляется Уведомления по электронной почте из 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
Используйте команду dbCompression, чтобы включить или отключить сжатие страниц базы данных для баз данных, используемых развертыванием Azure DevOps Server.
TfsConfig dbCompression /pageCompression:[enable|disable]
/sqlInstance:<serverName>
/databaseName:<databaseName>
[/rebuildNow [/offline]]
| Параметр | Описание |
|---|---|
| pageCompression | Указывает, включаете или отключаете сжатие страниц для данного экземпляра SQL и базы данных. |
| sqlInstance | Указывает имя сервера, на котором размещена база данных, для которой включено или отключено сжатие страниц, а также имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. При указании экземпляра необходимо использовать следующий формат: ServerName\InstanceName |
| databaseName | Указывает имя базы данных, для которой включено или отключено сжатие страниц. |
| rebuildNow | Необязательный элемент. Указывает, следует ли немедленно перестраивать (а также сжимать или распаковывать) индексы базы данных. Если индексы не используются, индексы будут перестроены фоновым заданием, которое выполняется еженедельно. |
| автономно | Необязательный элемент. Используется только в сочетании с /rebuildNow. Если параметр /offline не указан, индексы будут перестроены в режиме "в сети". Если задан параметр /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
Используйте команду deleteTestResults для удаления старых сохраненных результатов теста из хранилища коллекций. Обычно это делается для уменьшения размера хранилища или сокращения времени, затраченного на перенос результатов теста в новую схему.
TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
[/type:[automated|manual|all]]
[/preview]
| Параметр | Описание |
|---|---|
| ageInDays | Результаты теста старше указанного числа дней будут удалены или предварительно просмотрированы. |
| sqlInstance | Имя сервера, на котором размещена база данных, для которой удаляются или просматриваются результаты теста, и имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. При указании экземпляра необходимо использовать формат : ServerName\InstanceName. |
| databaseName | Имя базы данных, для которой удаляются или просматриваются результаты теста. |
| тип | Необязательный элемент. Тип удаляемых результатов теста. Допустимые значения: автоматические, ручные и все. |
| предварительный просмотр | Необязательный элемент. Отображение количества результатов теста, которые будут удалены в зависимости от возраста в днях, но не удаляйте эти результаты. |
Предварительные требования
Чтобы использовать команду 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 автоматически обработает изменения идентификатора безопасности для перемещения в том же лесу.
TfsConfig identities [/change /fromdomain:<domainName1> /todomain:<domainName2>
[/account:<accountName> [/toaccount:<accountName>]] [/sqlInstance:<serverName> /databaseName:<databaseName>]
| Параметр | Описание |
|---|---|
| Изменить | Указывает, что требуется изменить, а не перечислить идентификаторы. |
| fromdomain | Требуется при использовании /change. Задает исходный домен идентификаторов, которые нужно изменить. При переходе из среды рабочей группы указывает имя компьютера. |
| todomain | Требуется при использовании /change. Задает имя домена, для которого нужно изменить идентификаторы. При переходе в среду рабочей группы указывает имя компьютера. |
| account | Задает имя учетной записи, для которой требуется перечислить или изменить идентификаторы. |
| 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.
В следующем примере показано, как изменить идентификаторы безопасности для всех учетных записей в Azure DevOps Server с домена Contoso1 на идентификаторы безопасности для учетных записей с совпадающими именами в домене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"
Задания
С помощью команды jobs можно создать файл журнала, который предоставляет сведения о последнем действии задания для определенной коллекции проектов, или повторить задание для одной или всех коллекций проектов.
TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]
| Параметр | Описание |
|---|---|
| retry | Требуется, если /dumplog не используется. Указывает, что последнее задание будет повторно преобразовано для указанной коллекции проектов. При использовании этого параметра необходимо также использовать параметр /CollectionName или /CollectionID . |
| dumplog | Требуется, если параметр /retry не используется. Указывает, что последнее действие задания для коллекции будет отправлено в файл журнала. Если вы используете этот параметр, необходимо также использовать параметр /CollectionName или /CollectionID . |
| CollectionName | Требуется, если параметр /CollectionID не используется. Указывает имя коллекции, для которой будет повторно выполнено последнее задание (/retry) или в журнале (/dumplog). Если вы хотите указать все коллекции, можно использовать звездочку (*). |
| CollectionID | Требуется, если параметр /CollectionName не используется. Указывает идентификационный номер коллекции, для которой будет повторно выполнено последнее задание (/retry) или в журнале (/dumplog). |
Предварительные требования
Чтобы использовать команду jobs , необходимо быть членом группы безопасности Администраторы 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
Используйте команду offlineDetach , чтобы преобразовать автономную базу данных коллекций в отсоединяемую базу данных автономной коллекции.
TfsConfig offlineDetach /configurationDB:<databaseName>
/collectionDB:<databaseName>
| Параметр | Описание |
|---|---|
| configurationDB | Указывает имя используемой базы данных конфигурации. |
| 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
Proxy (Прокси)
Вы можете использовать команду прокси-сервера для обновления или изменения параметров, используемых прокси-сервером 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]
| Параметр | Описание |
|---|---|
| add | Добавляет указанный сервер или коллекцию в список прокси в файле Proxy.config. Команду /add можно выполнить несколько раз, чтобы включить несколько коллекций или серверов. При использовании параметра /add с коллекцией, размещенной в Azure DevOps Services, вам будет предложено ввести учетные данные на Azure DevOps Services. |
| Изменить | Изменяет учетные данные, хранящиеся в учетной записи службы для Azure DevOps Services. Параметр /change используется только для Azure DevOps Services; его не следует использовать для локальных развертываний Azure DevOps Server. |
| удалить | Удаляет указанный сервер или коллекцию из списка прокси в файле Proxy.config. |
| account | Указывает учетную запись, используемую в качестве учетной записи службы для прокси-сервера в Azure DevOps Services. Этот параметр используется только для Azure DevOps Services в сочетании с параметром /change. Учетная запись службы по умолчанию, используемая для Azure DevOps Services, — "Служба учетных записей". |
| continue | Продолжает выполнение команды, даже если процесс проверки создает предупреждения. |
| Коллекция | Указывает URL-адрес коллекции проектов, размещенной на Azure DevOps Services, в AccountName.DomainName/CollectionName формате . |
| account | Указывает имя учетной записи, используемой в качестве учетной записи службы для Azure DevOps Services. Если имя учетной записи содержит пробелы, его необходимо заключить в кавычки (""). Все специальные символы в именах учетных записей необходимо вводить в соответствии с синтаксисом командной строки. |
| account | Указывает URL-адрес развертывания Azure DevOps Server в ServerURL:Port/tfs формате . |
| PersonalAccessTokenFile | При необходимости указывает путь к файлу, который содержит личный маркер доступа. Этот маркер будет использоваться для проверки подлинности коллекции или учетной записи при регистрации прокси-сервера. (Добавлено в TFS 2018 с обновлением 1) |
| Ввод данных | Необязательный элемент. Указывает дополнительные параметры и значения для использования при настройке прокси-сервера.! Например, значения для и GvfsRepositoryName можно использовать для GvfsProjectName настройки репозитория 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
Команду 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, будут перестроены. |
| reportingDataSourcePassword | Требуется, если база данных 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. |
| databaseName | Обязательный. Указывает имя базы данных конфигурации. Значение по умолчанию — 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 в экземпляре TeamDatabasesSQL Server .
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]
| Параметр | Описание |
|---|---|
| имя_базы_данных | Указывает имя сервера, на котором размещена база данных, которую вы хотите сопоставить для Azure DevOps Server, в дополнение к имени самой базы данных. |
| Экземпляры SQL | Указывает имя сервера, на котором выполняется SQL Server, в дополнение к имени экземпляра, если вы хотите использовать экземпляр, отличный от экземпляра по умолчанию. При указании нескольких серверов необходимо использовать запятую для разделения нескольких пар имен серверов и экземпляров. |
| AnalysisInstance | Необязательный элемент. Указывает имя сервера и экземпляра, на котором размещаются SQL Server Analysis Services. Используйте этот параметр, чтобы указать сервер и экземпляр, на котором размещена база данных служб Analysis Services. |
| AnalysisDatabaseName | Необязательный элемент. Указывает имя базы данных служб Analysis Services, которую необходимо использовать с Azure DevOps Server, если на сервере, указанном с параметром /AnalysisInstance, имеется несколько таких баз данных. |
| предварительный просмотр | Необязательный элемент. Отображает действия, которые необходимо предпринять для обновления конфигурации. |
| continue | Необязательный элемент. Указывает, что команда RemapDB должна продолжаться, даже если во время попытки найти одну или несколько баз данных возникает ошибка. При использовании параметра /continue все коллекции, базы данных которых не найдены на указанных серверах или серверах, будут перенастроены для использования сервера и экземпляра, на котором размещена база данных конфигурации. |
Предварительные требования
Чтобы использовать команду remapDBs, необходимо быть членом группы безопасности Azure DevOps Administrators и членом группы безопасности sysadmin для всех баз данных SQL Server, которые использует Azure DevOps Server. Дополнительные сведения см. в справочнике по разрешениям для 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
Команда repairJobQueue используется для исправления запланированных заданий, которые остановлены для узлов развертывания и сбора.
TfsConfig repairJobQueue
Предварительные требования
Чтобы использовать команду repairJobQueue , необходимо быть членом группы локальных администраторов на компьютере, на котором выполняется TfsConfig. Кроме того, необходимо быть членом роли безопасности sysadmin для всех экземпляров SQL Server, используемых развертыванием Azure DevOps Server.
Комментарии
Обычно вы используете команду repairJobQueue , если заметили, что какие-либо запланированные задания не выполняются.
Команда не принимает аргументов и требует настройки развертывания Azure DevOps Server.
Пример
TfsConfig repairJobQueue
Параметры
С помощью команды settings можно автоматизировать изменения в универсальном указателе ресурсов (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 и Администраторы на сервере уровня приложений. Дополнительные сведения см. в статье Настройка разрешений администратора для Azure DevOps Server.
Комментарии
Команда settings изменяет сведения о подключении для обмена данными между серверами в развертывании 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,...]>
Параметр
Описание
/uninstall
Указывает один или несколько компонентов, которые будут удалены с компьютера, на котором выполняется команда. Доступны следующие варианты: All, ApplicationTier, Поиск и VersionControlProxy.
Предварительные требования
Чтобы использовать команду установки , необходимо быть членом группы безопасности Администраторы Azure DevOps.
Примеры
В следующем примере удаляются все Azure DevOps Server функции с текущего компьютера.
TfsConfig setup /uninstall:All
В следующем примере удаляется уровень приложений и компоненты сборки с текущего компьютера.
TfsConfig setup /uninstall:ApplicationTier
TCM
При обновлении до последней версии Azure DevOps Server система автоматически пытается обновить компоненты управления тестированием, включая планы тестирования и наборы.
Если автоматическая миграция завершается сбоем, используйте команду TCM , чтобы вручную обновить планы тестирования и наборы тестов до соответствующих типов рабочих элементов (WIT).
TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
Параметр
Описание
/upgradeTestPlans
Требуется, если не используется параметр /upgradeStatus .
Преобразование существующего плана тестирования и наборов тестов к точке к планам тестирования и наборам тестов на базе рабочих элементов. Также будут обновлены существующие данные управления тестированием и связи между иными артефактами тестирования, такими как тестовые точки, тестовые запуски и результаты тестирования.
/upgradeStatus
Требуется, если не используется параметр /upgradeTestPlans .
Сообщает о состоянии миграции тестовых данных для указанного проекта. Также показывает, есть ли в указанном проекте хотя бы один план тестирования.
/CollectionName:CollectionName
Обязательный. Указывает коллекцию проектов, содержащую проект, для которого требуется перенести тестовые данные или проверка состояние миграции.
Если в имени коллекции проектов есть пробелы, заключите имя в кавычки, например Fabrikam Fibre Collection.
/TeamProjectName:TeamProjectName
Обязательный. Указывает проект, для которого требуется перенести тестовые данные или проверка состояние миграции. Этот проект должен быть определен в коллекции, указанной с помощью параметра /collectionName .
Если в имени проекта есть пробелы, заключите имя в кавычки, например "Мой проект".
Предварительные требования
Необходимо входить в группу безопасности {2>Администраторы Team Foundation<2} и быть администратором на сервере уровня приложений.
См. раздел Настройка разрешений администратора для 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 Fibre, размещенном в коллекции проектов по умолчанию (DefaultCollection):
tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"
Unattend
Доступность команд: 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]
| Параметр | Описание |
|---|---|
| create | Создает файл автоматической установки с указанным именем и параметрами. |
| Настройка | Настраивает Azure DevOps Server с помощью файла автоматической установки и указанных параметров. С этим параметром необходимо использовать /type или /unattendfile. |
| тип | Указывает тип используемой конфигурации. При использовании параметра /configure требуется указать параметр /type или /unattendfile, но не оба. |
| unattendfile | Задает создаваемый или используемый файл автоматической установки, а также исходный параметр —/create или /configure. При использовании параметра /configure необходимо указать параметр /unattendfile или /type. |
| Ввод данных | Необязательный элемент. Параметр /create (если используется) задает параметры и значения, которые будут использоваться при создании файла автоматической установки. Параметр /configure (если используется) задает дополнительные параметры и значения, которые будут использоваться совместно с файлом автоматической установки. В качестве альтернативы использованию параметра /inputs можно вручную внести изменения в файл автоматической установки, используя любой редактор обычного текста. Это необходимо для определенных типов входных данных, таких как ServiceAccountPassword или PersonalAccessToken, так как эти секретные значения нельзя задать с помощью параметра /inputs. |
| проверка | Необязательный элемент. Задает выполнение настройки, в ходе которого выполняются только проверки, основанные на файле автоматической установки, входных данных и типе конфигурации. Это альтернатива выполнению полной настройки. |
| continue | Необязательный элемент. Указывает, что параметры /create и /configure должны продолжать выполняться, невзирая на предупреждения проверок. |
| InstallType | Описание |
|---|---|
| NewServerBasic | Настраивает основные службы разработки для Azure DevOps Server. К ним относятся система управления версиями, рабочие элементы, сборка и при необходимости Поиск. |
| NewServerAdvanced | Настраивает основные службы разработки и разрешает необязательную настройку интеграции с Reporting Services. |
| Обновление | Обновления Azure DevOps Server до текущей версии с поддерживаемого предыдущего выпуска. |
| PreProductionUpgrade | Протестируйте обновление в существующем развертывании Azure DevOps Server в подготовительной среде. Обычно это делается с помощью баз данных, восстановленных из рабочих резервных копий. Этот сценарий включает в себя дополнительные действия, чтобы гарантировать, что новое развертывание не будет мешать рабочему развертыванию. |
| ApplicationTierOnlyBasic | Настройте новый уровень приложения, используя существующие параметры из предоставленной базы данных конфигурации. Этот параметр позволяет быстро получить новый уровень приложений, используя существующие параметры. Если вы хотите изменить существующие параметры, используйте вместо него тип Advanced ApplicationTierOnlyAdvanced. |
| ApplicationTierOnlyAdvanced | Настройте новый уровень приложений с полным контролем над всеми параметрами. Параметры по умолчанию будут использовать существующие значения из предоставленной базы данных конфигурации. Если вы хотите сохранить все существующие параметры, используйте вместо него тип ApplicationTierOnlyBasic. |
| Clone | Настройте новое развертывание Azure DevOps Server, которое является клоном существующего развертывания. Обычно это делается с помощью баз данных, восстановленных из рабочих резервных копий, для создания среды, в которой можно протестировать изменения конфигурации, расширения и другие изменения. Этот сценарий включает в себя дополнительные действия, чтобы гарантировать, что новое развертывание не будет мешать рабочему развертыванию. |
| Proxy (Прокси) | Настраивает службу прокси-сервера управления версиями. |
Предварительные требования
Вы должны быть членом группы Администраторы на компьютере, где выполняется установка программного обеспечения.
В зависимости от типа установки могут также потребоваться дополнительные разрешения администратора.
Например, если для установки Azure DevOps Server используется команда автоматической установки , необходимо быть участником группы sysadmin на экземпляре SQL Server, который будет поддерживать Azure DevOps Server. Дополнительные сведения см. в разделе Q & A статьи Добавление администраторов уровня сервера в Azure DevOps Server.
Комментарии
Прежде чем использовать команду автоматической установки для настройки Azure DevOps Server, необходимо создать учетные записи служб, которые будут использоваться в процессе развертывания. Кроме того, необходимо установить обязательное программное обеспечение для выбранного типа установки. В том числе Azure DevOps Server себя. Необходимо установить Azure DevOps Server но не нужно настраивать его, так как команда автоматической установки сделает это автоматически.
Команда автоматической настройки Azure DevOps Server компонентов. Она не выполняет первоначальную установку программного обеспечения. Команда настраивает ПО согласно заданным спецификациям после того, как данные TFS появятся на компьютере.
Примеры
В следующем примере показано, как создать автоматический файл для базовой установки 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 Build на сервере, используя FabrikamFiber\BuildSVC в качестве учетной записи службы сборки, а затем настроить Azure DevOps Server Build с помощью этого автоматического файла.
Важно!
В этом примере после создания файла автоматической установки администратор вручную вносит изменения в файл, чтобы указать пароль для учетной записи службы сборки. Добавление пароля в качестве входных данных с помощью ServiceAccountPassword=Password; не добавляет сведения о пароле в файл.
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
Вторая команда возвращает следующие сведения, включая имя сервера, на котором была настроена FabrikamFiberTFS сборка Azure DevOps, и коллекцию проектов, связанную с контроллером 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