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

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 — TFS 2013

Примечание

Предложение Azure DevOps Server раньше называлось Visual Studio Team Foundation Server.

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

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

Важно!

Селектор версии содержимого

Чтобы просмотреть содержимое, доступное для вашей платформы, убедитесь, что в селекторе версии над содержанием выбрана правильная версия этой статьи. Поддержка функций зависит от того, работаете ли вы в Azure DevOps Services или в локальной версии Azure DevOps Server, которая ранее называлась Team Foundation Server (TFS).

Чтобы определить, какую локальную версию вы используете, обратитесь к разделу Какую платформу/версию я использую?.

Примечание

Для TFS 2010 и более ранних версий некоторые из этих команд доступны в программе командной строки тфсадминутилс .

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

Средства командной строки Azure DevOps устанавливаются в каталог/Тулс сервера уровня приложений 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 не используется, учетная запись службы для уровня приложения будет изменена.
Add Добавляет новую учетную запись только к необходимым ресурсам. Полезно для сценариев балансировки сетевой нагрузки. Используйте флаг Continue, если некоторые коллекции недостижимы. Чтобы обновить все пропущенные коллекции, в дальнейшем можно будет выполнить команду "Добавить". Добавляет учетную запись в группы, необходимые для использования учетной записи в качестве учетной записи службы.
Присвойте параметру Настраивает службу для использования учетной записи, уже добавленной в ресурсы. Полезно для сценариев балансировки сетевой нагрузки.
DELETE Удаляет учетную запись из всех ресурсов. При удалении учетной записи следует использовать меры предосторожности, так как она может привести к отказу в обслуживании других серверов.
ресетовнер Если базы данных восстанавливаются в процессе перемещения, клонирования или аварийного восстановления, владелец базы данных может переключиться на администратора, восстанавливающего сервер. Этот параметр выполняет перебор всех баз данных и задает имя входа dbo для текущего владельца.
AccountType Описание
AdminConsole Пользователи консоли администрирования — это пользователи, которым для использования консоли были предоставлены минимальные разрешения для различных ресурсов.
ApplicationTier Изменяет учетную запись службы в appPool для основных веб-служб. TFSService
Proxy (Прокси) Изменяет учетную запись службы в appPool для прокси веб-служб. (Тфспрокси)
репортингдатасаурце Изменяет учетную запись, используемую отчетами для доступа к данным отчетов. TFSReports

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

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

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

Примечание

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

Параметр Описание
Учетная запись Указывает имя учетной записи, которую требуется добавить, изменить или удалить из указанного типа учетной записи, например /AccountType.: ApplicationTier.
Пароль Указывает пароль учетной записи службы. Этот параметр является необязательным, если используется системная учетная запись или учетная запись без пароля, например сетевая служба.
sqlInstance Используется только с /ресетовнер.

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

ServerName\InstanceName.
databaseName Используется только с /ресетовнер.

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

Предварительные условия

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

  • Группа безопасности "Администраторы DevOps Azure"
  • роль 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

Используйте команду Accounts для управления этими учетными записями служб TFS.

  • Учетная запись службы TFS
  • Учетная запись источников данных для 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] [/usesqlalwayson]
Параметр Описание
/Change Изменяет учетную запись, используемую в качестве учетной записи службы. Этот параметр добавляет указанную учетную запись во все необходимые группы, предоставляет ей необходимые компоненты, если это возможно, и настраивает службу для использования этой учетной записи. Если параметр /AccountType. не используется с этим параметром, учетная запись службы для уровня приложения будет изменена.
/add Добавляет учетную запись в группы, необходимые для использования учетной записи в качестве учетной записи службы. Этот параметр добавляет указанную учетную запись в необходимые группы и предоставляет ей разрешения, необходимые для работы в качестве учетной записи службы (если это возможно). Однако этот параметр не изменит учетную запись, используемую в качестве учетной записи службы. Этот параметр обычно используется в сценариях балансировки сетевой нагрузки (NLB). Этот параметр можно использовать с/континуе, если некоторые службы или базы данных могут быть недоступны в вашей среде.
команде Задает учетную запись в качестве учетной записи службы. Этот параметр не добавляет учетную запись в группы. Поэтому этот параметр следует использовать только с учетными записями, которые уже добавлены в необходимые группы и иметь необходимые разрешения. Этот параметр обычно используется в сценариях балансировки сетевой нагрузки.
/delete Удаляет учетную запись из указанного типа учетной записи. Этот параметр удаляет указанную учетную запись из необходимых групп и удаляет разрешения, необходимые для работы в качестве учетной записи службы (если это возможно). Однако этот параметр не изменит учетную запись, используемую в качестве учетной записи службы. Убедитесь, что этот параметр не используется для учетной записи, которую серверы в развертывании в настоящее время используют в качестве учетной записи службы.
/ресетовнер Изменяет владельца баз данных, которые Azure DevOps Server использует, в учетную запись, используемую для выполнения этой команды. Этот параметр выполняет итерацию всех баз данных и задает имя входа dbo для учетной записи, используемой для выполнения этой команды. Этот параметр может потребоваться использовать при перемещении или восстановлении развертывания.
/упдатепассворд Изменяет пароль учетной записи, используемой в качестве учетной записи службы. Этот параметр обновляет пароль для учетной записи, указанной для всех служб в Azure DevOps Server, использующих эту учетную запись.
/AccountType.: {AdminConsole | ApplicationTier | Репортингдатасаурце | -
  • AdminConsole: группа пользователей, имеющих минимальные разрешения, необходимые для открытия и использования консоли администрирования для Azure DevOps (AdminConsole).
  • ApplicationTier: учетная запись службы, используемая для Azure DevOps Server (TFSSERVICE)
  • Репортингдатасаурце: учетная запись источников данных для Reporting Services (TFSReports)
  • Прокси: учетная запись службы для Azure DevOps Server прокси-сервера (тфспрокси).

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

/Account: AccountName Указывает имя учетной записи, которую требуется добавить, изменить или удалить из указанного типа учетной записи, например /AccountType.: ApplicationTier. Укажите учетную запись в одной из следующих форм: Домаин\аккаунтнаме или Компутер\аккаунтнаме.. Если вы хотите использовать системную учетную запись, например сетевую службу или локальную систему, используйте формат Компутер\аккаунтнаме. Дополнительные сведения об указании системной учетной записи см. в примерах использования далее в этом разделе.
/Password: Пароль Указывает пароль учетной записи службы.

Примечание. Этот параметр является необязательным, если используется системная учетная запись или учетная запись без пароля, например сетевая служба.
/SQLInstance: Имя Используется только с /ресетовнер. Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если вы хотите использовать экземпляр, отличный от экземпляра по умолчанию. Необходимо указать имя и экземпляр в следующем формате:

ServerName\InstanceName.
/DatabaseName: Имя Используется только с /ресетовнер. Указывает имя базы данных, владельцем которой требуется изменить. С помощью этой команды вы сбрасываете владение указанной базой данных на учетную запись, под которой выполняется команда.
/континуе Обновляет все группы, недоступные при выполнении команды. Этот параметр обычно используется в сценариях балансировки сетевой нагрузки.
/усесклалвайсон Используется только с /ресетовнер в сочетании с /SQLInstance и /DatabaseName. Указывает, что базы данных входят в группу обеспечения доступности AlwaysOn в SQL Server. Если этот аргумент задан, в строке подключения задается параметр MultiSubnetFailover.

Дополнительные сведения см. в разделе группы доступности AlwaysOn (SQL Server).

Предварительные условия

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

  • Группа безопасности Администраторы Team Foundation
  • роль 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 \ неваккаунт, а пароль — на пароль.

TFSConfig Accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password

Добавьте учетную запись системы сетевой службы в группы учетных записей служб для Azure DevOps Server. (Системные учетные записи не имеют паролей.)

TFSConfig Accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

Измените владельца _ базы данных "хранилище TFS" на SQL Server "контосомаин" в именованном экземпляре "теамдатабасес" на учетную запись пользователя, под которой выполняется команда.

Примечание

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

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-адрес коллекции командных проектов.
TeamProject Обязательный. Указывает имя командного проекта.
шаблон Обязательный. Указывает имя шаблона процесса. Доступные варианты: Agile, CMMI и Scrum.
force Необязательный параметр. Указывает, что отчеты должны быть перезаписаны, если они уже существуют.

Предварительные условия

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

Примечания

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

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

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

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

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

Пример

В следующем примере показано, как добавить гибкие отчеты в MyProject проект в http://myTfsServer:8080/tfs/DefaultCollection коллекции проектов.

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

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

TfsConfig addProjectReports
        /collection:teamProjectCollectionUrl
        /teamProject:projectName
        /template:templateName
        [/force]
Параметр Описание
/Collection Обязательный. URL-адрес коллекции проектов.
/teamProject Обязательный. Указывает имя проекта.
/Template Обязательный. Указывает имя шаблона процесса. Доступные варианты: Agile, CMMI и Scrum.
/Force Необязательный параметр. Указывает, что отчеты должны быть перезаписаны, если они уже существуют.

Предварительные условия

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

Примечания

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

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

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

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

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

Пример

В следующем примере показано, как добавить гибкие отчеты в проект 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.
/провидер: {NTLM | Новое Указывает поставщика проверки подлинности, который вы хотите настроить для веб-сайта.
  • NTLM: использование протокола проверки подлинности нтмл
  • Согласование: использование протокола проверки подлинности Negotiate (Kerberos)
/ситетипе Указывает веб-сайт (уровень приложения или прокси-сервер), Сетевой протокол проверки подлинности которого необходимо изменить. По умолчанию используется уровень приложения.

Предварительные условия

Чтобы использовать команду проверки подлинности , необходимо быть членом группы безопасности "Администраторы DevOps Azure" и локальным администратором на сервере уровня приложений или прокси-сервере в зависимости от значения параметра sitetype вместе .

Примечания

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

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

Пример

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

TFSConfig Authentication /viewAll

Команда authentication изменяет сетевой протокол проверки подлинности, используемый уровнем приложений или прокси-сервером TFS.

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]
Параметр Описание
/виевалл Отображает текущие параметры проверки подлинности для Azure DevOps Server.
/провидер: {NTLM | Новое Указывает поставщика проверки подлинности, который вы хотите настроить для веб-сайта.
  • NTLM: использование протокола проверки подлинности нтмл
  • Согласование: использование протокола проверки подлинности Negotiate (Kerberos)
/ситетипе Указывает веб-сайт (уровень приложения или прокси-сервер), Сетевой протокол проверки подлинности которого необходимо изменить. По умолчанию используется уровень приложения.

Предварительные условия

Чтобы использовать команду проверки подлинности , необходимо быть членом группы безопасности Администраторы Team Foundation и локальным администратором на сервере уровня приложений или прокси-сервере в зависимости от значения параметра sitetype вместе .

Примечания

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

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

Пример

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

TFSConfig Authentication /viewAll

Сертификаты

Используйте команду Certificates , чтобы изменить настройку сертификатов для проверки подлинности клиента в развертывании Azure DevOps Server, ИСПОЛЬЗУЮЩЕЙ протокол HTTPS, SSL и сертификаты.

TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]
Параметр Описание
компьютер Указывает, что список сертификатов будет находиться в контексте локального компьютера, а не в контексте текущего пользователя.
disable Указывает, что параметр сертификата проверки подлинности клиента будет отключен.
Автовыбор Указывает, что сертификат будет автоматически выбран из списка сертификатов. Окно "Управление сертификатами клиента" не откроется.
noprompt Указывает, что окно Управление сертификатами клиента не будет открываться при выполнении команды Certificates.
отпечатки Указывает, что будет использоваться сертификат, соответствующий указанному отпечатку. Можно указать несколько сертификатов, разделив отдельные отпечатки запятыми.

Предварительные условия

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

Примечания

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

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

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

Примеры

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

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

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

TfsConfig certificates /autoselect

Используйте команду Certificates , чтобы изменить настройку сертификатов для проверки подлинности клиента в развертывании Azure DevOps Server, ИСПОЛЬЗУЮЩЕЙ протокол HTTPS, SSL и сертификаты.

TFSConfig Certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]
Параметр Описание
/machine Указывает, что список сертификатов будет находиться в контексте локального компьютера, а не в контексте текущего пользователя.
/Disable Указывает, что параметр сертификата проверки подлинности клиента будет отключен.
/autoSelect Указывает, что сертификат будет автоматически выбран из списка сертификатов. Окно "Управление сертификатами клиента" не откроется.
/noprompt Указывает, что окно Управление сертификатами клиента не будет открываться при выполнении команды Certificates.
/thumbprints: отпечаток Указывает, что будет использоваться сертификат, соответствующий указанному отпечатку. Можно указать несколько сертификатов, разделив отдельные отпечатки запятыми.

Предварительные условия

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

Примечания

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

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

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

Примеры

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

TFSConfig Certificates /machine /thumbprint:aa bb cc dd ee /noprompt

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

TFSConfig Certificates /autoselect

ChangeServerID

Команда 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 для коллекций.
конфигдбонли Указывает, что будет изменен только идентификатор 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

Команда ChangeServerID изменяет идентификаторы GUID, связанные с базами данных для TFS. Идентификаторы GUID должны быть уникальными в пределах развертывания TFS. Если несколько баз данных имеют одинаковый идентификатор GUID, развертывание может стать нестабильным или непригодным для использования. Можно изменить идентификатор GUID для базы данных конфигурации, идентификаторы GUID для всех баз данных коллекции проектов в развертывании или и то, и другое. Хотя эта команда обычно не используется в ежедневных операциях, эту команду можно использовать в следующих случаях.

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

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

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

  • Необходимо сбросить идентификатор GUID для базы данных коллекции после его перемещения в другое развертывание, для которого этот идентификатор GUID уже зарезервирован.

    Примечание

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

    TFSConfig ChangeServerID/SQLInstance: ServerName/DatabaseName: Конфигуратиондатабасенаме [/Прожектколлектионсонли] [/Конфигдбонли] [/усесклалвайсон]

Параметр Описание
/SQLInstance: servername Обязательный. Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если вы хотите использовать экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName
/DatabaseName: DatabaseName Обязательный. Задает имя базы данных конфигурации для Azure DevOps Server. По умолчанию для этой базы данных используется имя TFS_ConfigurationDB.
/прожектколлектионсонли Указывает, что будут изменены только идентификаторы GUID для коллекций.
/конфигдбонли Указывает, что будет изменен только идентификатор GUID для базы данных конфигурации.
/усесклалвайсон Указывает, что базы данных входят в группу обеспечения доступности AlwaysOn в SQL Server. Если этот аргумент задан, в строке подключения задается параметр MultiSubnetFailover.

Дополнительные сведения см. в разделе группы доступности AlwaysOn (SQL Server).

Предварительные условия

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

Примечания

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

Пример

В следующем примере показано, как изменить идентификаторы GUID всех баз данных в Contoso1 развертывании Azure DevOps Server, где база данных конфигурации размещается на сервере с именем "Контосомаин" в именованном экземпляре "Теамдатабасес" в 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>]
Параметр Описание
индексингстатус Отображает состояние и конфигурацию службы индексации кода.
сетиндексинг on: запустить индексацию всех наборов изменений.
off: остановить индексацию всех наборов изменений.
keepupOnly: остановить индексацию созданных ранее наборов изменений и запустить индексацию только новых наборов изменений.
игнорелист Определяет список файлов исходного кода и путей к ним, которые необходимо исключить из индексирования.

add: добавить файл, который необходимо исключить из индексации, в список игнорируемых файлов.
remove: удалить файл, который необходимо включить в индексацию, из списка игнорируемых файлов.
removeAll: очистить список игнорируемых файлов и начать индексировать все файлы.
view: просмотреть полный список файлов, которые не будут индексироваться.
Серверпас: указывает путь к файлу кода.

Можно использовать подстановочный знак (*) в начале, в конце, или на обоих концах серверного пути.
листларжефилес Просмотреть определенное количество файлов, размер которых превышает заданный размер в кБ. Можно воспользоваться параметром /ignoreList, чтобы исключить эти файлы из индексации.

Для этого вам потребуется Team Foundation Server 2013 с обновлением 3.
реиндексалл Очистить ранее индексированные данные и перезапустить индексирование.
дестройкодеиндекс Удалить индекс кода и все индексированные данные. Не требует подтверждения, если используется параметр /noPrompt.
темпораридатасизелимит Управляйте количеством временных данных, которые создает CodeLens при обработке наборов изменений. Ограничение по умолчанию — 6 ГБ (2 ГБ в обновлении 5).

view: отображение текущего ограничения на размер.
Сизеингбс: измените предельный размер.
disable: удаление ограничения на размер.

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

Для этого вам потребуется Team Foundation Server 2013 с обновлением 4.
индексхисторипериод Управляйте длительностью индексирования журнала изменений. Это влияет на объем отображаемого журнала CodeLens. Ограничение по умолчанию составляет 12 месяцев. Это означает, что CodeLens показывает журнал изменений только за последние 12 месяцев.

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

Для этого вам потребуется 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"

Доступность команды: TFS 2015 и TFS 2013

Используйте команду 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]
Параметр Описание

/индексингстатус

Отображает состояние и конфигурацию службы индексации кода.

/setIndexing:[ON | OFF | keepupOnly]

  • on: запустить индексацию всех наборов изменений.

  • off: остановить индексацию всех наборов изменений.

  • keepupOnly: остановить индексацию созданных ранее наборов изменений и запустить индексацию только новых наборов изменений.

/ignoreList:[Add | Remove | removeAll | View] серверпас

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

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

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

  • removeAll: очистить список игнорируемых файлов и начать индексировать все файлы.

  • view: просмотреть полный список файлов, которые не будут индексироваться.

  • Серверпас: указывает путь к файлу кода.

    Можно использовать подстановочный знак (*) в начале, в конце, или на обоих концах серверного пути.

/листларжефилес [/филекаунт: filecount /минсизе: minSize]

Просмотреть определенное количество файлов, размер которых превышает заданный размер в кБ. Можно воспользоваться параметром /ignoreList, чтобы исключить эти файлы из индексации.

Для этого вам потребуется Team Foundation Server 2013 с обновлением 3.

/реиндексалл

Очистить ранее индексированные данные и перезапустить индексирование.

/Дестройкодеиндекс [/noPrompt]

Удалить индекс кода и все индексированные данные. Не требует подтверждения, если используется параметр /noPrompt.

/темпораридатасизелимит: [View | < Сизеингбс > | включен

Управляйте количеством временных данных, которые создает CodeLens при обработке наборов изменений. Ограничение по умолчанию — 6 ГБ (2 ГБ в обновлении 5).

  • view: отображение текущего ограничения на размер.

  • Сизеингбс: измените предельный размер.

  • disable: удаление ограничения на размер.

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

Для этого вам потребуется Team Foundation Server 2013 с обновлением 4.

/индексхисторипериод: [Просмотр | все | < Нумберофмонсс > ]

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

  • view: отображение текущего количества месяцев.

  • all: индексирование всего журнала изменений.

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

Для этого вам потребуется Team Foundation Server 2013 с обновлением 4.

/CollectionName: CollectionName

Задает имя коллекции проектов, для которой необходимо выполнить команду CodeIndex. Является обязательным, если не используется параметр /CollectionId.

/CollectionID: CollectionID

Задает идентификационный номер коллекции проектов, для которой необходимо выполнить команду CodeIndex. Является обязательным, если не используется параметр /CollectionName.

Предварительные условия

Для использования команды CodeIndex необходимо являться членом группы безопасности Администраторы Team Foundation. См. раздел Справочник по разрешениям для 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 и /клоне с этим параметром. При использовании параметра /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 и /клоне, он указывает имя дубликата коллекции.
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.

Предварительные условия

Чтобы использовать команду " коллекции ", необходимо быть членом группы безопасности "Администраторы 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

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

TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName]
        [/collectionDB:ServerName;DatabaseName] [/clone]

Параметры

Параметр Описание
/Attach Требуется, если не используется ни /Detach , ни /Delete . При указании этого параметра необходимо также использовать параметр воспользоваться/collectionDB. . В качестве варианта также можно использовать /CollectionName и /клоне с этим параметром. При использовании параметра /attach указанная база данных коллекции будет добавлена в развертывание Azure DevOps Server.
/detach Требуется, если не используется ни /attach , ни /Delete . При указании этого параметра необходимо также использовать параметр /CollectionName . При использовании параметра /Detach база данных для указанной коллекции будет остановлена, а коллекция будет отсоединена от развертывания Azure DevOps Server.
/delete Требуется, если не используется ни /Detach , ни /attach . При указании этого параметра необходимо также использовать параметр /CollectionName . При использовании параметра /Delete база данных для указанной коллекции будет остановлена, а коллекция будет безвозвратно отсоединена от Azure DevOps Server. Вы не сможете повторно подключить базу данных коллекции к этому или любому другому развертыванию.

Совет. Параметр /Delete не приведет к удалению базы данных коллекции из SQL Server. После удаления базы данных сбора из Azure DevOps Server базу данных можно удалить вручную из SQL Server.
/CollectionName: CollectionName Задает имя коллекции проектов. Если имя коллекции содержит пробелы, необходимо заключить имя в кавычки (например, " Моя коллекция " ). Требуется, если используется значение /Detach или /Delete . При использовании этого параметра с /Detach или /Deleteуказывается коллекция, которая будет отсоединена или удалена. При использовании этого параметра с параметром /attachон указывает новое имя для коллекции. Если этот параметр используется вместе с /attach и /клоне, он указывает имя дубликата коллекции.
Воспользоваться/collectionDB.: ServerName; DatabaseName Требуется, если используется /attach . Этот параметр указывает имя сервера, на котором работает SQL Server, и имя базы данных коллекции, размещенной на этом сервере.
  • ServerName: указывает имя сервера, на котором размещается база данных конфигурации для Azure DevOps Server, и имя экземпляра, если вы хотите использовать экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName .
  • DatabaseName: задает имя базы данных конфигурации. По умолчанию для этой базы данных используется имя TFS_ConfigurationDB.
/клоне Если указать этот параметр, исходная база данных коллекции будет присоединена в качестве клона в SQL Server, а эта база данных будет присоединена к Azure DevOps Server. Этот параметр в основном используется в процессе разбиения коллекции проектов.

Предварительные условия

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

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

Примечания

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

Примеры

В следующем примере показано, как окончательно удалить коллекцию проектов "проекты" для Contoso лето "из развертывания 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 летом ", назовите ее" «интернирование в Contoso» и подключите повторяющуюся коллекцию к развертыванию 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 Server, работающем на сервере с именованным ContosoMain экземпляром TeamDatabases .

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

Используйте команду ColumnStoreIndex , чтобы включить или отключить индексы хранилища столбцов для баз данных, используемых при развертывании TFS.

TfsConfig columnStoreIndex /enabled:{true|false}
        /sqlInstance:ServerName
        /databaseName:DatabaseName
Параметр Описание
/Enabled Указывает, следует ли включить или отключить индекс хранилища столбцов для заданного экземпляра SQL и базы данных.
/sqlInstance Указывает имя сервера, на котором размещена база данных, для которой включен или отключен индекс хранилища столбцов, а также имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName
/databaseName Указывает имя базы данных, для которой включен или отключен индекс хранилища столбцов.

Предварительные условия

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

Примечания

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

Пример

В следующем примере показано, как включить индекс хранилища столбцов для базы данных с именем TFS _ DefaultCollection в экземпляре SQL Server, работающем на сервере с именем «контосомаин» в именованном экземпляре «теамдатабасес».

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

конфигуремаил Настройте сервер, на котором работает Azure DevOps Server, на использование существующего SMTP-сервера для оповещений по электронной почте.TfsConfig configureMail /Enabled:<true|false> /FromEmailAddress:<emailAddress> /SmtpHost:<SMTPHostName>### Предварительные условияЧтобы использовать команду конфигуремаил , необходимо быть членом группы безопасности "Администраторы Team Foundation" на сервере уровня приложений Azure DevOps. Дополнительные сведения см. в статье Справочник по разрешениям для Azure DevOps Server### ПримечанияМожно также использовать консоль администрирования , чтобы настроить Azure DevOps Server для использования SMTP-сервера.### ПримерВ следующем примере показан синтаксис, используемый для настройки адреса отправителя TFS@contoso.com и почтового сервера SMTP следующим образом ContosoMailServer :TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer


дбкомпрессион

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

TfsConfig dbCompression /pageCompression:[enable|disable]
    /sqlInstance:<serverName>
    /databaseName:<databaseName>
    [/rebuildNow [/offline]]
Параметр Описание
пажекомпрессион Указывает, включается или отключается сжатие страниц для данного экземпляра SQL и базы данных.
sqlInstance Указывает имя сервера, на котором размещена база данных, для которой включено или отключено сжатие страниц, а также имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName
databaseName Указывает имя базы данных, для которой включено или отключено сжатие страниц.
ребуилднов Необязательный параметр. Указывает, следует ли немедленно перестраивать индексы базы данных (а также сжимать или распаковывать их при необходимости). Если не используется, индексы будут перестроены в фоновом задании, которое выполняется еженедельно.
автономно Необязательный параметр. Используется только в сочетании с /ребуилднов. Если /оффлине не указан, индексы будут перестроены в режиме в сети. Если указан /оффлине , индексы будут перестроены в автономном режиме. Это приведет к блокировке других операций, но может выполняться быстрее, чем перестроение индекса в сети.

Предварительные условия

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

Примечания

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

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

Пример

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

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

Для TFS 2012 и более ранних версий см https://support.microsoft.com/kb/2712111 . раздел.

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

TFSConfig dbCompression /pageCompression:{enable|disable}
        /sqlInstance:ServerName
        /databaseName:DatabaseName
        [/rebuildNow [/offline]]
Параметр Описание
/пажекомпрессион Указывает, включается или отключается сжатие страниц для данного экземпляра SQL и базы данных.
/sqlInstance Указывает имя сервера, на котором размещена база данных, для которой включено или отключено сжатие страниц, а также имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName
/databaseName Указывает имя базы данных, для которой включено или отключено сжатие страниц.
/ребуилднов Необязательный параметр. Указывает, следует ли немедленно перестраивать индексы базы данных (а также сжимать или распаковывать их при необходимости). Если не используется, индексы будут перестроены в фоновом задании, которое выполняется еженедельно.
/оффлине Необязательный параметр. Используется только в сочетании с /ребуилднов. Если /оффлине не указан, индексы будут перестроены в режиме в сети. Если указан /оффлине , индексы будут перестроены в автономном режиме. Это приведет к блокировке других операций, но может выполняться быстрее, чем перестроение индекса в сети.

Предварительные условия

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

Примечания

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

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

Пример

В следующем примере показано немедленное включение сжатия страниц с индексами, перестроенными в режиме в сети, для базы данных с именем TFS _ DefaultCollection в экземпляре SQL Server, работающем на сервере с именем «контосомаин» в именованном экземпляре «теамдатабасес».

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

делететестресултс

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

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]
Параметр Описание
ажеиндайс Результаты теста старше указанного числа дней будут удалены или предварительно получены.
sqlInstance Имя сервера, на котором размещена база данных, для которой выполняется удаление или просмотр результатов теста, а также имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName .
databaseName Имя базы данных, для которой удаляются или отображаются результаты теста.
тип Необязательный параметр. Тип удаляемых результатов теста. Допустимые значения: автоматизированный, ручнойи все.
предварительный просмотр Необязательный параметр. Отображает количество результатов тестов, которые будут удалены в зависимости от возраста в днях, но не удаляют эти результаты.

Предварительные условия

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

Примечания

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

Пример

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

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

Доступность команды: TFS 2017 и более поздние версии

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

TFSConfig DeleteTestResults /ageInDays:{number} 
    /sqlInstance:ServerName
    /databaseName:DatabaseName
    [/type:{automated|manual|all}]
    [/preview]
Параметр Описание
/ажеиндайс Результаты теста старше указанного числа дней будут удалены или предварительно получены.
/sqlInstance Имя сервера, на котором размещена база данных, для которой выполняется удаление или просмотр результатов теста, а также имя экземпляра, если используется экземпляр, отличный от используемого по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName
/databaseName Имя базы данных, для которой удаляются или отображаются результаты теста.
/Type Необязательный параметр. Тип удаляемых результатов теста. Допустимые значения: автоматизированный, ручнойи все.
/Preview Необязательный параметр. Отображает количество результатов тестов, которые будут удалены в зависимости от возраста в днях, но не удаляют эти результаты.

Предварительные условия

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

Примечания

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

Пример

В следующем примере показано, как удалить результаты ручного теста старше 60 дней для базы данных с именем TFS _ DefaultCollection в экземпляре SQL Server, работающем на сервере с именем «контосомаин» в именованном экземпляре «теамдатабасес».

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

деплойментпул

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

TfsConfig deploymentpool /migrateDeploymentGroups /fromPool:<source pool name> /toPool:<destination pool name>
Параметр Описание
фромпул Имя исходного пула.
топул Имя целевого пула.

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>]
Параметр Описание
Изменить Указывает, что требуется изменить, а не перечислить идентификаторы.
фромдомаин Требуется при использовании /Change. Задает исходный домен идентификаторов, которые нужно изменить. При переходе из среды рабочей группы указывает имя компьютера.
тодомаин Требуется при использовании /Change. Задает имя домена, для которого нужно изменить идентификаторы. При переходе в среду рабочей группы указывает имя компьютера.
account Задает имя учетной записи, для которой требуется перечислить или изменить идентификаторы.
тоаккаунт Задает имя учетной записи, для которой требуется изменить идентификаторы.
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 , идентификатор безопасности учетной записи будет изменен на SID для 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 , а затем снова измените учетную запись на сетевую службу на сервере в новом домене. База данных конфигурации размещается на сервере, имя которого указано 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"

Команда удостоверения перечисляет или изменяет идентификатор безопасности (SID) пользователей и групп в развертывании TFS. Изменить или обновить идентификатор безопасности для пользователей и групп может потребоваться в одном из следующих случаев:

  • изменение домена развертывания;

  • переход из рабочей группы в домен или из домена в рабочую группу;

  • миграция учетных записей между доменами в Active Directory.

    Примечание

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

    TFSConfig identitys [/Change/фромдомаин: DomainName1/тодомаин: DomainName2 [/Account: имя_учетной_записи] [/тоаккаунт: AccountName]] [/sqlInstance: ServerName/databaseName: DatabaseName] [/Account: имя_учетной_записи] [/усесклалвайсон]

Параметр Описание
/Change Указывает, что требуется изменить, а не перечислить идентификаторы.
/фромдомаин: Имя_домена Требуется при использовании /Change. Задает исходный домен идентификаторов, которые нужно изменить. При переходе из среды рабочей группы указывает имя компьютера.
/тодомаин: Имя_домена Требуется при использовании /Change. Задает имя домена, для которого нужно изменить идентификаторы. При переходе в среду рабочей группы указывает имя компьютера.
/Account: AccountName Задает имя учетной записи, для которой требуется перечислить или изменить идентификаторы.
/тоаккаунт: AccountName Задает имя учетной записи, для которой требуется изменить идентификаторы.
/SQLInstance: Имя Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если вы хотите использовать экземпляр, отличный от экземпляра по умолчанию. При задании экземпляра необходимо использовать следующий формат:

имя_сервера\имя_экземпляра
/DatabaseName: Имя Задает имя базы данных конфигурации для Azure DevOps Server.
/усесклалвайсон Указывает, что базы данных входят в группу обеспечения доступности AlwaysOn в SQL Server. Если этот аргумент задан, в строке подключения задается параметр MultiSubnetFailover.

Дополнительные сведения см. в разделе группы доступности AlwaysOn (SQL Server).

Предварительные условия

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

Примечания

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

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

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

Примеры

В следующем примере показано, как вывести список имен всех пользователей и групп Windows, которые хранятся в Azure DevOps Server, а также сведения о том, соответствует ли идентификатор безопасности для каждого пользователя или группы идентификатору безопасности в Windows. Администраторы домена Contoso1 создали группы домена, такие как "Contoso1 \ Developers" и "Contoso1 \ Tester", чтобы упростить управление разрешениями для 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 на идентификаторы безопасности для учетных записей, имеющих совпадающие имена в домене Контосоприме. Идентификаторы безопасности будут обновлены только для совпадающих имен учетных записей. Например, если учетная запись "ххолт" существует как Contoso1 \ ххолт и контосоприме \ ХХОЛТ, идентификатор безопасности учетной записи будет изменен на SID для контосоприме \ ххолт. Если \ учетная запись "контосоприме ххолт" не существует, идентификатор безопасности не будет обновлен для Contoso1 \ ххолт.

TFSConfig Identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

В следующем примере показано, как изменить учетную запись для одной учетной записи пользователя Contoso1 \ ххолт на учетную запись для другой учетной записи пользователя контосоприме \ жпеоплес.

TFSConfig Identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

В следующем примере показано, как изменить идентификатор безопасности \ учетной записи службы "Сетевая служба NT Authority", которая используется в развертывании Azure DevOps Server при изменении домена развертывания с Contoso1 на контосоприме. Чтобы изменить системную учетную запись, например сетевой службы, необходимо выполнить двухэтапную процедуру. Сначала измените учетную запись службы с \ сетевой службы NT Authority на учетную запись домена в новом домене (темпсвк), а затем измените учетную запись обратно на сетевую службу на сервере в новом домене. База данных конфигурации размещается на сервере с именем "Контосомаин" в именованном экземпляре "Теамдатабасес" в 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>]
Параметр Описание
retry Требуется, если /dumplog. не используется. Указывает, что Последнее задание будет повторено для указанной коллекции проектов. При использовании этого параметра необходимо также использовать параметр /CollectionName или /CollectionID .
dumplog Требуется, если /Retry не используется. Указывает, что последнее действие задания для коллекции будет отправлено в файл журнала. При использовании этого параметра необходимо также использовать параметр /CollectionName или /CollectionID .
CollectionName Требуется, если /CollectionID не используется. Указывает имя коллекции, для которой будет выполнена повторная попытка выполнения последней задачи (/Retry) или журнал (/dumplog.). Если необходимо указать все коллекции, можно использовать звездочку (*).
CollectionID Требуется, если /CollectionName не используется. Указывает идентификационный номер коллекции, для которой будет выполнена повторная попытка выполнения последней задачи (/Retry) или журнал (/dumplog.).

Предварительные условия

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

Примечания

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

Пример

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

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

Команду задания можно использовать для создания файла журнала, который содержит сведения о последних действиях заданий для определенной коллекции проектов, или на повтор задания для одной или всех коллекций проектов.

TFSConfig Jobs /retry|dumplog [/CollectionName:CollectionName] [/CollectionID:ID]
Параметр Описание
/Retry Требуется, если /dumplog. не используется. Указывает, что Последнее задание будет повторено для указанной коллекции проектов. При использовании этого параметра необходимо также использовать параметр /CollectionName или /CollectionID .
/dumplog. Требуется, если /Retry не используется. Указывает, что последнее действие задания для коллекции будет отправлено в файл журнала. При использовании этого параметра необходимо также использовать параметр /CollectionName или /CollectionID .
/CollectionName: CollectionName Требуется, если /CollectionID не используется. Указывает имя коллекции, для которой будет выполнена повторная попытка выполнения последней задачи (/Retry) или журнал (/dumplog.). Если необходимо указать все коллекции, можно использовать звездочку (*).
/CollectionID: УДОСТОВЕРЕНИЯ Требуется, если /CollectionName не используется. Указывает идентификационный номер коллекции, для которой будет выполнена повторная попытка выполнения последней задачи (/Retry) или журнал (/dumplog.).

Предварительные условия

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

Примечания

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

Пример

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

TFSConfig Jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"

Lab/Delete

Используйте параметр TfsConfig Lab/Delete , чтобы удалить все узлы групп, общие папки библиотеки и среды из указанной коллекции проектов. По умолчанию связанные объекты в System Center Virtual Machine Manager (SCVMM) не удаляются. В командную строку можно добавить параметр /External для удаления объектов из коллекции проектов и из SCVMM.

TfsConfig Lab /Delete /CollectionName:collectionName [/External] [/NoPrompt]
Параметр Описание
CollectionName: CollectionName Обязательный. Указывает имя коллекции проектов на уровне приложения Azure DevOps Server.
External Необязательный параметр. Если этот параметр указан, в дополнение к объектам в коллекции проектов удаляет общие папки библиотеки и группы узлов в SCVMM. Если /External не указан, команда TfsConfig Lab/Delete удаляет только объекты из коллекции проектов.
NoPrompt Необязательный параметр. При указании не отображает сведения о ходе выполнения и выполнении.

Примечания

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

Примечание

Параметр /Delete работает для всех ресурсов лаборатории в коллекции проектов только в том случае, если параметры /либраришаре и /грауфост не указаны в командной строке. Дополнительные сведения см. в статьях TfsConfig Lab/Либраришаре Commands и TfsConfig Lab/хостграуп Commands.

Пример

В следующем примере удаляются все лабораторные объекты из коллекции проектов DefaultCollection. Поскольку параметр /External не указан, объекты сохраняются в SCVMM.

tfsconfig lab /delete /collectionName:DefaultCollection

Используйте параметр TfsConfig Lab/Delete , чтобы удалить все узлы групп, общие папки библиотеки и среды из указанной коллекции проектов. По умолчанию связанные объекты в System Center Virtual Machine Manager (SCVMM) не удаляются. В командную строку можно добавить параметр /External для удаления объектов из коллекции проектов и из SCVMM.

TfsConfig Lab /Delete /CollectionName:collectionName [/External] [/NoPrompt]
Параметр Описание
CollectionName: CollectionName Обязательный. Указывает имя коллекции проектов на уровне приложения Azure DevOps Server.
External Необязательный параметр. Если этот параметр указан, в дополнение к объектам в коллекции проектов удаляет общие папки библиотеки и группы узлов в SCVMM. Если /External не указан, команда TfsConfig Lab/Delete удаляет только объекты из коллекции проектов.
NoPrompt Необязательный параметр. При указании не отображает сведения о ходе выполнения и выполнении.

Примечания

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

Примечание

Параметр /Delete работает для всех ресурсов лаборатории в коллекции проектов только в том случае, если параметры /либраришаре и /грауфост не указаны в командной строке. Дополнительные сведения см. в статье TfsConfig Lab/Либраришаре Commands(.. Команды/тфсконфиг-КМД.МД # Lab-LibraryShare) и TfsConfig Lab/хостграуп.

Пример

В следующем примере удаляются все лабораторные объекты из коллекции проектов DefaultCollection. Поскольку параметр /External не указан, объекты сохраняются в SCVMM.

tfsconfig lab /delete /collectionName:DefaultCollection

/ДНС лаборатории

Команда TfsConfig Lab/ДНС добавляет, удаляет или ОТОБРАЖАЕТ записи DNS, созданные Visual Studio Lab Management для сред, изолированных от сети.

    TfsConfig Lab /DNS 
    {/Add | /Delete | /List}
        [/CollectionName:collectionName |
        / CollectionName:collectionName /TeamProject:projectName |
        / CollectionName:collectionName /TeamProject:projectName /LabEnvironment:environmentUri |
        /Name:FQDN /IP:IpAddress]
        [/NoPrompt]
Параметр Описание
Добавление Добавляет указанные записи DNS. Чтобы использовать параметр /Add , необходимо запустить целевые среды.
Удалить Удаляет указанные записи DNS.
Список Отображает указанные записи DNS.
Базовойлабораторной: енвиронментури Обращается к параметрам /Add, /Delete или /List к отдельной изолированной от сети среде, заданной параметром енвиронментури.

Чтобы использовать параметр базовойлабораторной , необходимо также указать параметры /Collection и /TeamProject .
TeamProject: имя_проекта При использовании без /лабенвиронмент обращается к параметрам /Add, /Delete или /List ко всем изолированным от сети окружениям в проекте, указанном в ProjectName. В противном случае /TeamProject указывает проект, содержащий среду.

Чтобы использовать параметр /TeamProject , необходимо также указать параметр /Collection .
CollectionName: CollectionName При использовании без /TeamProject обращается к параметрам /Add, /Delete или /List ко всем изолированным от сети окружениям в коллекции проектов, указанной в CollectionName. В противном случае /Collection указывает коллекцию проектов, содержащую проект.
Имя: ПОЛН Указывает полное доменное имя сетевого расположения, содержащего целевую среду.

Необходимо указать параметры /Name и /IP вместе.
IP-адрес: IP Указывает IP-адрес целевой среды.

Необходимо указать параметры /Name и /IP вместе.

Примечания

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

Если в развертывание сервера Team Foundation Server включено несколько уровней приложений и каждый уровень приложений запускается под собственной учетной записью службы, каждой учетной записи службы уровня приложений необходимо предоставить разрешение на изменение записей псевдонимов DNS, созданных другими уровнями приложений.

Примечание

Управление записями DNS выполняется автоматически Lab Management. Команда /ДНС должна использоваться только в следующих ситуациях:

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

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

Укажите только один из параметров /Add, /Delete или /List в командной строке TfsConfig Lab/ДНС . Если целевые параметры не заданы, операция действует на всех виртуальных машинах всех изолированных сетевых сред, принадлежащих ко всем коллекциям проектов в базе данных Team Foundation Server.

Чтобы ориентироваться на записи DNS изолированных от сети окружений объекта в Lab Management иерархии объектов, используйте соответствующее сочетание параметров /Collection, /TeamProject и /лабенвиронмент .

  • Параметр /лабенвиронмент предназначен для команды в указанной сетевой среде. Для указания коллекции проектов и проекта, содержащего среду, необходимо использовать параметры /CollectionName и /TeamProject с параметром /лабенвиронмент .

    Чтобы указать универсальный код ресурса среды, используйте формат vstfs:///LabManagement/LabEnvironment/ идентификатора среды. Идентификатор среды (Енвиронмнетид) можно просмотреть в средстве просмотра окружения Lab Management или в описании виртуальной машины в диспетчере SCVMM консоль администратора.

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

  • Параметр /CollectionName предназначен для операции с сетевыми изолированными окружениями в указанной коллекции проектов.

Второй способ ориентироваться на сетевую изолированную среду — использование параметров /Name и /IP для указания полного внешнего имени и внешнего IP-адреса отдельной виртуальной машины. В командной строке необходимо указать оба параметра /Name и /IP . Внешнее имя и внешний IP-адрес виртуальной машины можно просмотреть в средстве просмотра окружения Lab Management или в описании виртуальной машины в SCVMM консоль администратора.

Примеры

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

tfsconfig lab /dns /add /collectionname:Collection0 /teamproject:Project1
tfsconfig lab /dns /delete /name:0b668996-2736-46d2-88ac-0733acbd0d9c.contoso.com /ip:111.00.000.000

Команда TfsConfig Lab/ДНС добавляет, удаляет или ОТОБРАЖАЕТ записи DNS, созданные Visual Studio Lab Management для сред, изолированных от сети.

TfsConfig Lab /DNS 
{/Add | /Delete | /List}
    [/CollectionName:collectionName |
    / CollectionName:collectionName /TeamProject:projectName |
    / CollectionName:collectionName /TeamProject:projectName /LabEnvironment:environmentUri |
    /Name:FQDN /IP:IpAddress]
    [/NoPrompt]
Параметр Описание
Добавление Добавляет указанные записи DNS. Чтобы использовать параметр /Add , необходимо запустить целевые среды.
Удалить Удаляет указанные записи DNS.
Список Отображает указанные записи DNS.
Базовойлабораторной: енвиронментури Обращается к параметрам /Add, /Delete или /List к отдельной изолированной от сети среде, заданной параметром енвиронментури.

Чтобы использовать параметр базовойлабораторной , необходимо также указать параметры /Collection и /TeamProject .
TeamProject: имя_проекта При использовании без /лабенвиронмент обращается к параметрам /Add, /Delete или /List ко всем изолированным от сети окружениям в проекте, указанном в ProjectName. В противном случае /TeamProject указывает проект, содержащий среду.

Чтобы использовать параметр /TeamProject , необходимо также указать параметр /Collection .
CollectionName: CollectionName При использовании без /TeamProject обращается к параметрам /Add, /Delete или /List ко всем изолированным от сети окружениям в коллекции проектов, указанной в CollectionName. В противном случае /Collection указывает коллекцию проектов, содержащую проект.
Имя: ПОЛН Указывает полное доменное имя сетевого расположения, содержащего целевую среду.

Необходимо указать параметры /Name и /IP вместе.
IP-адрес: IP Указывает IP-адрес целевой среды.

Необходимо указать параметры /Name и /IP вместе.

Примечания

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

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

Примечание

Управление записями DNS выполняется автоматически Lab Management. Команда /ДНС должна использоваться только в следующих ситуациях:

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

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

Укажите только один из параметров /Add, /Delete или /List в командной строке TfsConfig Lab/ДНС . Если целевые параметры не заданы, операция действует на всех виртуальных машинах всех изолированных сетевых сред, принадлежащих ко всем коллекциям проектов в базе данных Azure DevOps Server.

Чтобы ориентироваться на записи DNS изолированных от сети окружений объекта в Lab Management иерархии объектов, используйте соответствующее сочетание параметров /Collection, /TeamProject и /лабенвиронмент .

  • Параметр /лабенвиронмент предназначен для команды в указанной сетевой среде. Для указания коллекции проектов и проекта, содержащего среду, необходимо использовать параметры /CollectionName и /TeamProject с параметром /лабенвиронмент .

    Чтобы указать универсальный код ресурса среды, используйте формат vstfs:///LabManagement/LabEnvironment/ идентификатора среды. Идентификатор среды (Енвиронмнетид) можно просмотреть в средстве просмотра окружения Lab Management или в описании виртуальной машины в диспетчере SCVMM консоль администратора.

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

  • Параметр /CollectionName предназначен для операции с сетевыми изолированными окружениями в указанной коллекции проектов.

Второй способ ориентироваться на сетевую изолированную среду — использование параметров /Name и /IP для указания полного внешнего имени и внешнего IP-адреса отдельной виртуальной машины. В командной строке необходимо указать оба параметра /Name и /IP . Внешнее имя и внешний IP-адрес виртуальной машины можно просмотреть в средстве просмотра окружения Lab Management или в описании виртуальной машины в SCVMM консоль администратора.

Примеры

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

REM First example
tfsconfig lab /dns /add /collectionname:Collection0 /teamproject:Project1

REM Second example
tfsconfig lab /dns /delete /name:0b668996-2736-46d2-88ac-0733acbd0d9c.contoso.com /ip:111.00.000.000

/Хостграуп лаборатории

Используйте команды TfsConfig Lab/хостграуп , чтобы добавить, изменить или удалить назначение группы узлов System Center Virtual Machine Manager (SCVMM) в коллекции проектов. Группы узлов, назначенные таким образом, управляются с помощью Visual Studio Lab Management.

TfsConfig Lab /hostgroup /CollectionName:collectionName
      { /Add 
            /SCVMMHostGroup:vmmHostPath 
            /Name:name 
            [LabEnvironmentPlacementPolicy:{Conservative|Aggressive}]
            [/AutoProvision:{True|False}]
            [/DNSSuffix:dnsSuffix]
       | /Delete 
            /Name:name
            [/NoPrompt]
       | /Edit 
            /Name:name
            {[/AutoProvision:{True|False}] 
            [/LabEnvironmentPlacementPolicy:{Conservative|Aggressive}] 
            [/DNSSuffix:dnsSuffix]}
            [/NoPrompt]]
       | /List
       | /ListSCVmmHostGroups }

Параметр

Описание

CollectionName: CollectionName

Обязательный. Имя коллекции проектов на Azure DevOps Server уровня приложения.

Добавление

Добавляет указанную группу узлов SCVMM в группы узлов коллекции проектов. Необходимо указать параметры /сквммхостграуп и /Name с помощью Add.

Удалить

Удаляет указанную группу узлов из коллекции проектов. Параметр /Name необходимо указать с помощью команды Delete.

Правка

Задает одно или оба свойства Lab Management Автонаполнения и лабенвиронментплацементполици для группы узлов.

Необходимо указать параметр /Name и хотя бы один из параметров /аутопровисион или /лабенвиронментплацементполици с параметром Edit.

Сквммхостграуп: вммх остграуппас

Требуется с параметром /Add . Задает путь к узлу группы узлов SCVMM.

Имя: имя

Требуется с параметрами /Add, /Deleteили /Edit . Укажите имя группы узлов коллекции проектов для добавления, удаления или изменения.

Автоинициализация:{true | false}

Необязательно с параметрами /Add или /Edit . Задает значение (true) или очищает (false) свойство автонаполнения группы узлов. Автонаполнение определяет, будет ли группа узлов автоматически назначена каждому проекту в коллекции. По умолчанию группы узлов назначаются проектам в коллекции при использовании команды TfsConfig Lab/HostGroup .

Лабенвиронментплацементполици:{консервативнный | агрессивный}

Необязательно с параметрами /Add или /Edit . Указывает, как Lab Management обрабатывает физические компьютеры в группе узлов, в которой он развертывает новые виртуальные лабораторные среды.

  • Консервативный (по умолчанию). Рассмотрите возможность использования не выполняющихся виртуальных сред в решениях развертывания. Сюда входят все виртуальные машины, являющиеся частью окружений, которые также находятся в " остановленном " состоянии.

  • Агрессивный Не учитывайте неработающие виртуальные среды при принятии решений о развертывании.

DNSSuffix:[DNSSuffix]

Необязательный параметр. Задает или DNS-суффикс виртуальных компьютеров в группе узлов.

  • Если параметр /днссуффикс: указан без значения DNSSuffix, устанавливает или сбрасывает DNS-суффикс суффикса виртуальных компьютеров в суффикс главного компьютера в группе узлов.

  • Если параметр /днссуффикс не указан вместе с параметром /Add , то суффиксу виртуальных компьютеров присваивается суффиксы узлов компьютеров в группе узлов.

  • Если параметр /днссуффикс не указан с параметром /Edit , суффикс виртуальных компьютеров не изменяется.

NoPrompt

Необязательно с параметрами /Delete или /Edit . У пользователя не запрашивается подтверждение.

Список

Отображает группы узлов, назначенные коллекции проектов.

листсквммхостграупс

Отображает группы узлов, доступные из SCVMM.

Примечания

Группы узлов — это контейнеры, которые администратор создает в SCVMM для группировки набора узлов виртуальных машин для облегчения управления. Группы узлов являются иерархическими; одна группа узлов может содержать другие группы узлов.

Каждая группа узлов определяется по пути к узлу, последовательности имен групп узлов, указывающей расположение узла, или по группе узлов в иерархии групп узлов в SCVMM. Все пути к узлам начинаются с корневой группы узлов. Например, путь к узлу All Hosts\\New York\\Site21\\VMHost05 указывает, что узел VMHost05 принадлежит группе узлов Site21, которая является дочерней группой узлов группы узлов Нью-Йорк.

Используйте только один из параметров /Add, /Delete или /Edit в командной строке. Используйте отдельные командные строки TfsConfig Lab/хостграуп , чтобы назначить несколько групп узлов коллекции проектов.

Для задания свойств, относящихся к Lab Management, можно также использовать команды TfsConfig Lab/хостграуп :

  • Автоинициализация указывает, назначена ли группа узлов каждому проекту в коллекции проектов. По умолчанию параметр AutoProvision включен. Чтобы назначить группу узлов в коллекции проектов отдельному проекту, используйте команду TFSLabConfig креатетеампрожексостграуп.

    • True (по умолчанию). Группа узлов назначается каждому проекту в коллекции проектов.

    • False. Группа узлов не назначена каждому проекту в коллекции проектов.

  • Лабенвиронментплацементполици указывает, рассматривает ли Lab Management существующие виртуальные машины при развертывании новых сред на физическом компьютере в группе узлов.

    • Консервативный (по умолчанию). Рассмотрите возможность использования не выполняющихся виртуальных сред в решениях развертывания. Сюда входят все виртуальные машины, являющиеся частью сред и находящиеся в состоянии "Остановлена".

    • Агрессивный Не учитывайте неработающие виртуальные среды при принятии решений о развертывании.

  • DNSSuffix указывает DNS-суффикс, используемый для виртуальных компьютеров, созданных в группе узлов. В следующей таблице описывается, как на DNS-суффиксы виртуальных компьютеров влияет параметр /DNSSuffix.

DNSSuffix /Add /Edit
DNSSuffix: днсвалуе DNS-суффикс имеет значение Днсвалуе. DNS-суффикс имеет значение Днсвалуе.
DNSSuffix DNS-суффикс наследуется от главного компьютера. Существующее значение суффикса удаляется, а DNS-суффикс наследуется от главного компьютера.
<Не указано> DNS-суффикс наследуется от главного компьютера. DNS-суффикс не изменяется.

Пример

В следующем примере группа узлов SCVMM назначается коллекции проектов. Так как параметры /аутопровисион не указаны, группа узлов автоматически назначается всем проектам в коллекции.

tfsconfig lab /hostgroup /add /scvmmhostgroup:"All Hosts\Lab1\HostGroup1" /collection:Collection0
        /name:Lab1Collection0_Lab1_HostGroup1

Используйте команды TfsConfig Lab/хостграуп , чтобы добавить, изменить или удалить назначение группы узлов System Center Virtual Machine Manager (SCVMM) в коллекции проектов. Группы узлов, назначенные таким образом, управляются с помощью Visual Studio Lab Management.

TfsConfig Lab /hostgroup /CollectionName:collectionName
  { /Add 
        /SCVMMHostGroup:vmmHostPath 
        /Name:name 
        [LabEnvironmentPlacementPolicy:{Conservative|Aggressive}]
        [/AutoProvision:{True|False}]
        [/DNSSuffix:dnsSuffix]
   | /Delete 
        /Name:name
        [/NoPrompt]
   | /Edit 
        /Name:name
        {[/AutoProvision:{True|False}] 
        [/LabEnvironmentPlacementPolicy:{Conservative|Aggressive}] 
        [/DNSSuffix:dnsSuffix]}
        [/NoPrompt]]
   | /List
   | /ListSCVmmHostGroups }

Параметр

Описание

CollectionName: CollectionName

Обязательный. Имя коллекции проектов на Azure DevOps Server уровня приложения.

Добавление

Добавляет указанную группу узлов SCVMM в группы узлов коллекции проектов. Необходимо указать параметры /сквммхостграуп и /Name с помощью Add.

Удалить

Удаляет указанную группу узлов из коллекции проектов. Параметр /Name необходимо указать с помощью команды Delete.

Правка

Задает одно или оба свойства Lab Management Автонаполнения и лабенвиронментплацементполици для группы узлов.

Необходимо указать параметр /Name и хотя бы один из параметров /аутопровисион или /лабенвиронментплацементполици с параметром Edit.

Сквммхостграуп: вммх остграуппас

Требуется с параметром /Add . Задает путь к узлу группы узлов SCVMM.

Имя: имя

Требуется с параметрами /Add, /Deleteили /Edit . Укажите имя группы узлов коллекции проектов для добавления, удаления или изменения.

Автоинициализация:{true | false}

Необязательно с параметрами /Add или /Edit . Задает значение (true) или очищает (false) свойство автонаполнения группы узлов. Автонаполнение определяет, будет ли группа узлов автоматически назначена каждому проекту в коллекции. По умолчанию группы узлов назначаются проектам в коллекции при использовании команды TfsConfig Lab/HostGroup .

Лабенвиронментплацементполици:{консервативнный | агрессивный}

Необязательно с параметрами /Add или /Edit . Указывает, как Lab Management обрабатывает физические компьютеры в группе узлов, в которой он развертывает новые виртуальные лабораторные среды.

  • Консервативный (по умолчанию). Рассмотрите возможность использования не выполняющихся виртуальных сред в решениях развертывания. Сюда входят все виртуальные машины, являющиеся частью окружений, которые также находятся в " остановленном " состоянии.

  • Агрессивный Не учитывайте неработающие виртуальные среды при принятии решений о развертывании.

DNSSuffix:[DNSSuffix]

Необязательный параметр. Задает или DNS-суффикс виртуальных компьютеров в группе узлов.

  • Если параметр /днссуффикс: указан без значения DNSSuffix, устанавливает или сбрасывает DNS-суффикс суффикса виртуальных компьютеров в суффикс главного компьютера в группе узлов.

  • Если параметр /днссуффикс не указан вместе с параметром /Add , то суффиксу виртуальных компьютеров присваивается суффиксы узлов компьютеров в группе узлов.

  • Если параметр /днссуффикс не указан с параметром /Edit , суффикс виртуальных компьютеров не изменяется.

NoPrompt

Необязательно с параметрами /Delete или /Edit . У пользователя не запрашивается подтверждение.

Список

Отображает группы узлов, назначенные коллекции проектов.

листсквммхостграупс

Отображает группы узлов, доступные из SCVMM.

Примечания

Группы узлов — это контейнеры, которые администратор создает в SCVMM для группировки набора узлов виртуальных машин для облегчения управления. Группы узлов являются иерархическими; одна группа узлов может содержать другие группы узлов.

Каждая группа узлов определяется по пути к узлу, последовательности имен групп узлов, указывающей расположение узла, или по группе узлов в иерархии групп узлов в SCVMM. Все пути к узлам начинаются с корневой группы узлов. Например, путь к узлу All Hosts\\New York\\Site21\\VMHost05 указывает, что узел VMHost05 принадлежит группе узлов Site21, которая является дочерней группой узлов группы узлов Нью-Йорк.

Используйте только один из параметров /Add, /Delete или /Edit в командной строке. Используйте отдельные командные строки TfsConfig Lab/хостграуп , чтобы назначить несколько групп узлов коллекции проектов.

Для задания свойств, относящихся к Lab Management, можно также использовать команды TfsConfig Lab/хостграуп :

  • Автоинициализация указывает, назначена ли группа узлов каждому проекту в коллекции проектов. По умолчанию параметр AutoProvision включен. Чтобы назначить группу узлов в коллекции проектов отдельному проекту, используйте команду TFSLabConfig креатетеампрожексостграуп.

    • True (по умолчанию). Группа узлов назначается каждому проекту в коллекции проектов.

    • False. Группа узлов не назначена каждому проекту в коллекции проектов.

  • Лабенвиронментплацементполици указывает, рассматривает ли Lab Management существующие виртуальные машины при развертывании новых сред на физическом компьютере в группе узлов.

    • Консервативный (по умолчанию). Рассмотрите возможность использования не выполняющихся виртуальных сред в решениях развертывания. Сюда входят все виртуальные машины, являющиеся частью сред и находящиеся в состоянии "Остановлена".

    • Агрессивный Не учитывайте неработающие виртуальные среды при принятии решений о развертывании.

  • DNSSuffix указывает DNS-суффикс, используемый для виртуальных компьютеров, созданных в группе узлов. В следующей таблице описывается, как на DNS-суффиксы виртуальных компьютеров влияет параметр /DNSSuffix.

DNSSuffix /Add /Edit
DNSSuffix: днсвалуе DNS-суффикс имеет значение Днсвалуе. DNS-суффикс имеет значение Днсвалуе.
DNSSuffix DNS-суффикс наследуется от главного компьютера. Существующее значение суффикса удаляется, а DNS-суффикс наследуется от главного компьютера.
<Не указано> DNS-суффикс наследуется от главного компьютера. DNS-суффикс не изменяется.

Пример

В следующем примере группа узлов SCVMM назначается коллекции проектов. Так как параметры /аутопровисион не указаны, группа узлов автоматически назначается всем проектам в коллекции.

tfsconfig lab /hostgroup /add /scvmmhostgroup:"All Hosts\Lab1\HostGroup1" /collection:Collection0
            /name:Lab1Collection0_Lab1_HostGroup1

/Либраришаре лаборатории

Для добавления, удаления или изменения назначения общей папки библиотеки из System Center Virtual Machine Manager (SCVMM) в коллекцию проектов можно использовать команду TfsConfig Lab/либраришаре . Вы также можете использовать эти свойства набора команд, которые относятся к Visual Studio Lab Management и для вывода общих папок библиотеки, назначенных в данный момент коллекции в Lab Management или для вывода всех общих папок библиотеки в SCVMM.

TfsConfig Lab /LibraryShare
    /CollectionName:collectionName
     { /Add 
       /SCVMMLibraryShare:librarySharePath 
       /Name:name 
        [/AutoProvision:{True|False}]
    | /Delete 
       /Name:name 
        [/NoPrompt]
    | /Edit 
       /Name:name 
       /AutoProvision:{True|False} 
        [/NoPrompt]
    | /List
    | /ListSCVMMLibraryShares }
Параметр Описание
Добавление Добавляет указанную общую папку библиотеки в коллекцию проектов. Необходимо указать параметры /сквммлибраришаре и /Name с помощью Add.
Удалить Удаляет указанную общую папку библиотеки из коллекции проектов. Параметр /Name необходимо указать с помощью команды Delete.
Правка Задает или очищает свойство автонаполнения общей папки библиотеки. Необходимо указать параметры /Name и /аутопровисион с параметром Edit.

По умолчанию общие папки библиотеки назначаются проектам в коллекции.

Изменение автоматической инициализации влияет на существующие проекты.
CollectionName: CollectionName Обязательный. Укажите имя коллекции проектов в Azure DevOps Server уровня приложения.
Сквммлибраришаре: librarysharePath Требуется с Add. Указывает путь к общей папке библиотеки диспетчер виртуальных машин.
Имя: либраришаренаме Требуется с добавлением, удалением и изменением. Указывает имя общей папки библиотеки в коллекции проектов.
Свойство AutoProvision Необязательно с добавлением; требуется с Edit. Указывает, будут ли общие папки библиотеки автоматически назначаться каждому проекту в коллекции. По умолчанию общие папки библиотеки назначаются проектам.
NoPrompt Необязательно с добавлением и изменением. У пользователя не запрашивается подтверждение.
Список Список всех общих папок библиотеки, назначенных указанной коллекции проектов.
листсквммлибраришарес Список всех общих папок библиотеки, доступных в диспетчер виртуальных машин.

Примечания

Общая папка библиотеки — это назначенная общая папка на сервере библиотеки диспетчер виртуальных машин. Общая папка библиотеки предоставляет доступ к файловым ресурсам для виртуальных Lab Management сред, которые хранятся на серверах библиотек, таких как ISO-образы и виртуальные жесткие диски. Общие папки библиотеки создаются в диспетчер виртуальных машин. Visual Studio Lab Management использует общие папки библиотеки для инициализации виртуальных машин в лаборатории.

Используйте только один из параметров /Add, /Edit или /Delete в командной строке TfsConfig Lab/либраришаре. Используйте отдельные командные строки TfsConfig Lab/либраришаре , чтобы назначить несколько общих папок библиотеки коллекции.

По умолчанию общие папки библиотеки в коллекции проектов автоматически назначаются каждому из проектов в коллекции. Для изменения назначенных общих папок библиотеки можно использовать параметр /аутопровисион с командами /Add и /Edit .

  • Задайте для параметра /Аутопровисион значение false , чтобы отключить автоматическое назначение общей папки библиотеки проектам. Чтобы назначить или удалить общую папку библиотеки в отдельном проекте, используйте команду TFSLabConfig TFSLabConfig креатетеампрожектлибраришаре.

  • Задайте для параметра /Аутопровисион значение true , чтобы включить автоматическое назначение.

Для добавления, удаления или изменения назначения общей папки библиотеки из System Center Virtual Machine Manager (SCVMM) в коллекцию проектов можно использовать команду TfsConfig Lab/либраришаре . Вы также можете использовать эти свойства набора команд, которые относятся к Visual Studio Lab Management и для вывода общих папок библиотеки, назначенных в данный момент коллекции в Lab Management или для вывода всех общих папок библиотеки в SCVMM.

TfsConfig Lab /LibraryShare
        /CollectionName:collectionName
        { /Add
            /SCVMMLibraryShare:librarySharePath
            /Name:name
            [/AutoProvision:{True|False}]
        | /Delete
            /Name:name
            [/NoPrompt]
        | /Edit
            /Name:name
            /AutoProvision:{True|False}
            [/NoPrompt]
        | /List
        | /ListSCVMMLibraryShares }
Параметр Описание
Добавление Добавляет указанную общую папку библиотеки в коллекцию проектов. Необходимо указать параметры /сквммлибраришаре и /Name с помощью Add.
Удалить Удаляет указанную общую папку библиотеки из коллекции проектов. Параметр /Name необходимо указать с помощью команды Delete.
Правка Задает или очищает свойство автонаполнения общей папки библиотеки. Необходимо указать параметры /Name и /аутопровисион с параметром Edit.

По умолчанию общие папки библиотеки назначаются проектам в коллекции.

[!NOTE] Изменение автоматической инициализации влияет на существующие проекты.
CollectionName: CollectionName Обязательный. Укажите имя коллекции проектов в Azure DevOps Server уровня приложения.
Сквммлибраришаре: librarysharePath Требуется с Add. Указывает путь к общей папке библиотеки диспетчер виртуальных машин.
Имя: либраришаренаме Требуется с добавлением, удалением и изменением. Указывает имя общей папки библиотеки в коллекции проектов.
Свойство AutoProvision Необязательно с добавлением; требуется с Edit. Указывает, будут ли общие папки библиотеки автоматически назначаться каждому проекту в коллекции. По умолчанию общие папки библиотеки назначаются проектам.
NoPrompt Необязательно с добавлением и изменением. У пользователя не запрашивается подтверждение.
Список Список всех общих папок библиотеки, назначенных указанной коллекции проектов.
листсквммлибраришарес Список всех общих папок библиотеки, доступных в диспетчер виртуальных машин.

Примечания

Общая папка библиотеки — это назначенная общая папка на сервере библиотеки диспетчер виртуальных машин. Общая папка библиотеки предоставляет доступ к файловым ресурсам для виртуальных Lab Management сред, которые хранятся на серверах библиотек, таких как ISO-образы и виртуальные жесткие диски. Общие папки библиотеки создаются в диспетчер виртуальных машин. Visual Studio Lab Management использует общие папки библиотеки для инициализации виртуальных машин в лаборатории.

Используйте только один из параметров /Add, /Edit или /Delete в командной строке TfsConfig Lab/либраришаре. Используйте отдельные командные строки TfsConfig Lab/либраришаре , чтобы назначить несколько общих папок библиотеки коллекции.

По умолчанию общие папки библиотеки в коллекции проектов автоматически назначаются каждому из проектов в коллекции. Для изменения назначенных общих папок библиотеки можно использовать параметр /аутопровисион с командами /Add и /Edit .

  • Задайте для параметра /Аутопровисион значение false , чтобы отключить автоматическое назначение общей папки библиотеки проектам. Чтобы назначить или удалить общую папку библиотеки в отдельном проекте, используйте команду TFSLabConfig TFSLabConfig креатетеампрожектлибраришаре.

  • Задайте для параметра /Аутопровисион значение true , чтобы включить автоматическое назначение.


/Settings лаборатории

Visual Studio Lab Management можно настроить с помощью параметра TfsConfig Lab/Settings . Параметр "Параметры"

  • Устанавливает имя сервера System Center Virtual Machine Manager (SCVMM), который управляет процессом администрирования виртуальных машин в вашей лаборатории.

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

  • Устанавливает IP-адреса и виртуальный DNS-суффикс для изолированных от сети сетей в вашей лаборатории.

TfsConfig Lab
    /Settings
        [/ScVmmServerName:VMMServerName]
        [/NetworkLocation:networkLocation]
        [/IpBlock:networkIsolationIpRange]
        [/DnsSuffix:networkIsolationDnsSuffix] 
        [/NoPrompt]
        [/List]
Параметр Описание
Сквммсервернаме: Имясервераvmm Необязательный параметр. Задает полное имя сервера System Center Virtual Machine Manager 2008 (SCVMM), который будет использоваться Azure DevOps Server. Это имя сервера SCVMM, который будет использоваться для управления виртуальными машинами. Чтобы Azure DevOps Server взаимодействовать с SCVMM, необходимо добавить учетную запись, под которой выполняется Azure DevOps Server, к роли администратора в SCVMM.
NetworkLocation: NetworkLocation Необязательный параметр. Устанавливает полное имя сети, например сетевого домена или рабочей группы, которое доступно на всех узлах в вашей лабораторной сети. При подготовке виртуальной машины Lab Management автоматически подключает виртуальную машину к указанной сети. Для поиска доступных сетевых папок на узле используйте консоль администрирования SCVMM.
IpBlock: нетворкисолатионипранже Необязательный параметр. Устанавливает диапазон IP-адресов, которые необходимо назначить виртуальным машинам в среде при создании изолированной сети. Так как IP-адреса используются только для внутренней маршрутизации между виртуальными машинами и не выходят за границы среды, можно указать любой диапазон IP-адресов, который не используется в сети, указанной параметром /нетворклокатион . В большинстве случаев должен работать диапазон по умолчанию 192.168.23.0/24. В случае обнаружения проблем при подключении к средами с сетевой изоляцией вам, возможно, придется выбрать другой диапазон.
DNSSuffix: нетворкисолатионднссуффикс Необязательный параметр. Устанавливает DNS-суффикс, который будет использоваться для регистрации имен виртуальных машин в изолированной сети для виртуальной среды. Для подтверждения правильной настройки суффикса в иерархии DNS обратитесь к администратору сети.
NoPrompt Необязательный параметр. Не запрашивать подтверждение. Не используйте с параметром /List .
Список Выводит список текущих значений конфигурации для Lab Management.

Примечания

Один из параметров /сквммсервернаме, /нетворклокатион, /ипблокк, /днссуффикс или /List должен быть указан в каждой командной строке TfsConfig Lab/Settings .

Чтобы настроить Lab Management, необходимо указать параметры /сквммсервернаме и /нетворклокатион . Однако эти параметры можно задать в разных командных строках.

Чтобы настроить сетевую изоляцию, необходимо указать оба параметра: /ипблокк и /днссуффикс . Однако эти параметры можно задать в разных командных строках.

Сетевая изоляция позволяет использовать несколько копий виртуальной машины без конфликтов на уровне имени компьютера или IP-адреса. Для изолированной сети необходимо назначить DNS-суффикс и диапазон IP-адресов. Так как эти IP-адреса используются только для внутренней маршрутизации между виртуальными машинами и недоступны за границами среды, можно указать любой диапазон IP-адресов, не используемый в общедоступной сети. В большинстве случаев должен работать диапазон по умолчанию 192.168.1.0/24. В случае обнаружения проблем при подключении к средами с сетевой изоляцией вам, возможно, придется выбрать другой диапазон.

Примеры

В этом примере Lab Management настраивается с помощью параметров /сквммсервернаме и /нетворклокатион в одной командной строке.

tfsconfig lab /settings /scvmmservername:vmmserver /networklocation:lab1.contoso.com

В этом примере сетевая изоляция настраивается с помощью параметров /ипблокк и /днссуффикс в отдельных командных строках.

tfsconfig lab /settings /ipblock: 192.168.23.0/24
tfsconfig lab /settings /dnssuffix:virtual1.lab1.contoso.com

Visual Studio Lab Management можно настроить с помощью параметра TfsConfig Lab/Settings . Параметр "Параметры"

  • Устанавливает имя сервера System Center Virtual Machine Manager (SCVMM), который управляет процессом администрирования виртуальных машин в вашей лаборатории.

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

  • Устанавливает IP-адреса и виртуальный DNS-суффикс для изолированных от сети сетей в вашей лаборатории.

    TfsConfig Lab/Settings [/Сквммсервернаме: Имясервераvmm] [/Нетворклокатион: networkLocation] [/Ипблокк: Нетворкисолатионипранже] [/Днссуффикс: Нетворкисолатионднссуффикс] [/NoPrompt] [/list]

Параметр Описание
Сквммсервернаме: Имясервераvmm Необязательный параметр. Задает полное имя сервера System Center Virtual Machine Manager 2008 (SCVMM), который будет использоваться Azure DevOps Server. Это имя сервера SCVMM, который будет использоваться для управления виртуальными машинами. Чтобы Azure DevOps Server взаимодействовать с SCVMM, необходимо добавить учетную запись, под которой выполняется Azure DevOps Server, к роли администратора в SCVMM.
NetworkLocation: NetworkLocation Необязательный параметр. Устанавливает полное имя сети, например сетевого домена или рабочей группы, которое доступно на всех узлах в вашей лабораторной сети. При подготовке виртуальной машины Lab Management автоматически подключает виртуальную машину к указанной сети. Для поиска доступных сетевых папок на узле используйте консоль администрирования SCVMM.
IpBlock: нетворкисолатионипранже Необязательный параметр. Устанавливает диапазон IP-адресов, которые необходимо назначить виртуальным машинам в среде при создании изолированной сети. Так как IP-адреса используются только для внутренней маршрутизации между виртуальными машинами и не выходят за границы среды, можно указать любой диапазон IP-адресов, который не используется в сети, указанной параметром /нетворклокатион . В большинстве случаев должен работать диапазон по умолчанию 192.168.23.0/24. В случае обнаружения проблем при подключении к средами с сетевой изоляцией вам, возможно, придется выбрать другой диапазон.
DNSSuffix: нетворкисолатионднссуффикс Необязательный параметр. Устанавливает DNS-суффикс, который будет использоваться для регистрации имен виртуальных машин в изолированной сети для виртуальной среды. Для подтверждения правильной настройки суффикса в иерархии DNS обратитесь к администратору сети.
NoPrompt Необязательный параметр. Не запрашивать подтверждение. Не используйте с параметром /List .
Список Выводит список текущих значений конфигурации для Lab Management.

Примечания

Один из параметров /сквммсервернаме, /нетворклокатион, /ипблокк, /днссуффикс или /List должен быть указан в каждой командной строке TfsConfig Lab/Settings .

Чтобы настроить Lab Management, необходимо указать параметры /сквммсервернаме и /нетворклокатион . Однако эти параметры можно задать в разных командных строках.

Чтобы настроить сетевую изоляцию, необходимо указать оба параметра: /ипблокк и /днссуффикс . Однако эти параметры можно задать в разных командных строках.

Сетевая изоляция позволяет использовать несколько копий виртуальной машины без конфликтов на уровне имени компьютера или IP-адреса. Для изолированной сети необходимо назначить DNS-суффикс и диапазон IP-адресов. Так как эти IP-адреса используются только для внутренней маршрутизации между виртуальными машинами и недоступны за границами среды, можно указать любой диапазон IP-адресов, не используемый в общедоступной сети. В большинстве случаев должен работать диапазон по умолчанию 192.168.1.0/24. В случае обнаружения проблем при подключении к средами с сетевой изоляцией вам, возможно, придется выбрать другой диапазон.

Примеры

В этом примере Lab Management настраивается с помощью параметров /сквммсервернаме и /нетворклокатион в одной командной строке.

tfsconfig lab /settings /scvmmservername:vmmserver /networklocation:lab1.contoso.com

В этом примере сетевая изоляция настраивается с помощью параметров /ипблокк и /днссуффикс в отдельных командных строках.

tfsconfig lab /settings /ipblock: 192.168.23.0/24
tfsconfig lab /settings /dnssuffix:virtual1.lab1.contoso.com

OfflineDetach

Команда 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 Server, работающем на сервере с именованным ContosoTemp экземпляром Backups .

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

Доступность команды: TFS 2015 с обновлением 3 и более поздние версии

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

TFSConfig offlineDetach /configurationDB:DatabaseName
        /collectionDB:DatabaseName
Параметр Описание
/configurationDB Указывает имя базы данных конфигурации, которая будет использоваться.
Воспользоваться/collectionDB. Указывает имя базы данных коллекции для отсоединения.

Предварительные условия

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

Примечания

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

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

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

Пример

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

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

Дополнительные сведения об установке прокси-сервера 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 формате.
персоналакцесстокенфиле При необходимости указывает путь к файлу, содержащему личный маркер доступа. При регистрации прокси-сервера этот маркер будет использоваться для проверки подлинности в коллекции или учетной записи. (Добавлено в TFS 2018 с обновлением 1)
Ввод данных Необязательный параметр. Задает дополнительные параметры и значения, используемые при настройке прокси-сервера.

Например, значения для GvfsProjectName и GvfsRepositoryName можно использовать для настройки репозитория Git для использования с виртуальной файловой системой Git (GVFS) (добавляется в TFS 2018 с обновлением 1).

Предварительные условия

Чтобы использовать команду прокси- сервера, необходимо быть членом группы безопасности "Администраторы DevOps Azure" и администратором на прокси-сервере. Дополнительные сведения см. в справочнике по разрешениям для 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

Для обновления или изменения параметров, используемых прокси Team Foundation Server, можно использовать команду TFSConfig proxy . Прокси-сервер Team Foundation Server позволяет распределенным командам использовать систему управления версиями за счет управления кэшем загруженных файлов системы управления версиями в местоположении распределенной команды. Настроив прокси Team Foundation Server, можно значительно уменьшить пропускную способность, необходимую для соединений по глобальной области. Кроме того, не требуется управлять загрузкой и кэшированием файлов версий; управление файлами прозрачно для разработчика, который их использует. В то же время обмен метаданными и передачами файлов по прежнему отображается в Azure DevOps Server. Если вы используете Azure DevOps Services для размещения проекта разработки в облаке, можно использовать команду прокси, чтобы не только управлять кэшем для проектов в размещенной коллекции, но и управлять некоторыми параметрами, используемыми этой службой.

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

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.
/Change Изменяет учетные данные, сохраненные в качестве учетной записи службы для Azure DevOps Services. Параметр/Change используется только для Azure DevOps Services; его не следует использовать для локальных развертываний Azure DevOps Server.
/delete Удаляет указанный сервер или коллекцию из списка прокси в файле Proxy.config.
/Account Указывает учетную запись, используемую в качестве учетной записи службы для прокси-сервера в Azure DevOps Services. Этот параметр используется только для Azure DevOps Services в сочетании с параметром/Change.

Учетная запись службы по умолчанию, используемая для Azure DevOps Services, — " Служба учетной записи."
/континуе Продолжает выполнение команды, даже если процесс проверки создает предупреждения.
/Collection: url_коллекции_командных_проектов Указывает URL-адрес коллекции проектов, которая размещается на Azure DevOps Services в AccountName.DomainName/CollectionName формате.
/Account: AccountName Указывает имя учетной записи, используемой в качестве учетной записи службы для Azure DevOps Services. Если имя учетной записи содержит пробелы, оно должно быть заключено в кавычки ( " " ). Все специальные символы в именах учетных записей необходимо вводить в соответствии с синтаксисом командной строки.
/Account: ServerUrl Указывает URL-адрес развертывания Azure DevOps Server в ServerURL:Port/tfs формате.
/Персоналакцесстокенфиле:P астофилевиспат При необходимости указывает путь к файлу, содержащему личный маркер доступа. При регистрации прокси-сервера этот маркер будет использоваться для проверки подлинности в коллекции или учетной записи. (Добавлено в TFS 2018 с обновлением 1)
/инпутс: key1 = значение1; Key2 = значение2;... Необязательный параметр. Задает дополнительные параметры и значения, используемые при настройке прокси-сервера.

Например, значения для " гвфспрожектнаме " и " гвфсрепоситоринаме " можно использовать для настройки репозитория Git для использования с виртуальной файловой системой Git (GVFS) (добавляется в TFS 2018 с обновлением 1).

Предварительные условия

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

Примечания

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

Примеры

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

The following example shows how to change the service account used by the proxy for the project collection hosted on Azure DevOps Services. The collection is named PhoneSaver, the account name used for Azure DevOps Services is HelenaPetersen.fabrikam.com, and the service account used by the proxy is being changed to "My Proxy Service Account". Because the account name contains spaces, quotation marks are used to enclose the name.

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

ребуилдварехаусе

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

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]
Параметр Описание
analysisServices Требуется, если не используется /ALL . Указывает, что будет выполнена перестроение только базы данных для Analysis Services. Если для Analysis Services не существует базы данных, необходимо также использовать параметр /репортингдатасаурцепассворд .
все Требуется, если /аналисиссервицес не используется. Указывает, что все базы данных отчетов и анализа, используемые Azure DevOps Server, будут перестроены.
репортингдатасаурцепассворд Требуется, если база данных TFS_Analysis не существует. Указывает пароль учетной записи, которая используется в качестве учетной записи источников данных для SQL Server Reporting Services (TFSReports). Дополнительные сведения см. в разделе Учетные записи служб и зависимости в Azure DevOps Server.

Предварительные условия

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

  • Группа безопасности "Администраторы DevOps Azure" и группа безопасности "Администраторы" на сервере или серверах, на которых запущена консоль администрирования для 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.

Для перестроения SQL Server Reporting Services и SQL Server Analysis Services баз данных, используемых Visual Studio Team Foundation Server (TFS), можно использовать команду ребуилдварехаусе .

TFSConfig RebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]
Параметр Описание
/аналисиссервицес Требуется, если не используется /ALL . Указывает, что будет выполнена перестроение только базы данных для Analysis Services. Если для Analysis Services не существует базы данных, необходимо также использовать параметр /репортингдатасаурцепассворд .
/all Требуется, если /аналисиссервицес не используется. Указывает, что все базы данных отчетов и анализа, используемые Azure DevOps Server, будут перестроены.
/репортингдатасаурцепассворд: Пароль Требуется, если база данных TFS_Analysis не существует. Указывает пароль учетной записи, которая используется в качестве учетной записи источников данных для SQL Server Reporting Services (TFSReports). Дополнительные сведения см. в разделе Учетные записи служб и зависимости в Azure DevOps Server.

Предварительные условия

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

  • Группа безопасности Администраторы Team Foundation и группа безопасности Администраторы на сервере или серверах, на которых выполняется консоль администрирования для 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 в экземпляре SQL Server TeamDatabases .

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

Используйте RegisterDB для обновления имени сервера, на котором размещается база данных конфигурации, в Visual Studio Team Foundation Server (TFS). Эту команду можно применять при восстановлении базы данных конфигурации в новое оборудование и при изменении домена развертывания.

TFSConfig RegisterDB /SQLInstance:ServerName /databaseName: DatabaseName [/usesqlalwayson]
Аргумент Описание
/SQLInstance: Имя Обязательный. Указывает имя сервера, на котором выполняется SQL Server, и имя экземпляра, если вы хотите использовать экземпляр, отличный от экземпляра по умолчанию. При указании экземпляра необходимо использовать формат: ServerName\InstanceName .
/DatabaseName: Имя Обязательный. Указывает имя базы данных конфигурации. Значение по умолчанию — Tfs_Configuration.
/усесклалвайсон Необязательный параметр. Указывает, что базы данных входят в группу обеспечения доступности AlwaysOn в SQL Server. Если этот аргумент задан, в строке подключения задается параметр MultiSubnetFailover.

Дополнительные сведения см. в разделе группы доступности AlwaysOn (SQL Server).

Предварительные условия

Чтобы использовать команду RegisterDB , необходимо быть членом группы администраторов Team Foundation на сервере уровня приложений для 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 в базу данных конфигурации, расположенную на сервере Контосомаин в SQL Server экземпляре Теамдатабасес.

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, в дополнение к имени самой базы данных.
склинстанцес Указывает имя сервера, на котором выполняется SQL Server, в дополнение к имени экземпляра, если вы хотите использовать экземпляр, отличный от экземпляра по умолчанию.

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

Предварительные условия

Чтобы использовать команду remapDBs , необходимо быть членом группы безопасности "Администраторы DevOps Azure" и членом группы безопасности 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

Команда RemapDBs перенаправляет Azure DevOps Server в свои базы данных, если они хранятся на нескольких серверах и восстанавливают, перемещают или иным образом изменяют конфигурацию развертывания. Например, необходимо перенаправить TFS на любые базы данных для коллекций проектов, если они размещены на отдельном сервере или серверах из базы данных конфигурации. Также необходимо перенаправить TFS на сервер или серверы, на которых выполняется SQL Server Analysis Services, или SQL Server Reporting Services, если эти базы данных размещаются на отдельном сервере или экземпляре из базы данных конфигурации.

TFSConfig RemapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
        [/AnalysisInstance:ServerName] [/AnalysisDatabaseName:DatabaseName]
        [/preview] [/continue] [/usesqlalwayson]
Параметр Описание
/DatabaseName Указывает имя сервера, на котором размещена база данных, которая будет сопоставлена Azure DevOps Server, в дополнение к имени самой базы данных.
/Склинстанцес: ServerName1,ServerName2 Указывает имя сервера, на котором выполняется SQL Server, в дополнение к имени экземпляра, если вы хотите использовать экземпляр, отличный от экземпляра по умолчанию.

При указании более одного сервера необходимо использовать запятую для разделения нескольких пар имен серверов и экземпляров.
/Аналисисинстанце: Имя Необязательный параметр. Указывает имя сервера и экземпляра, на котором размещается SQL Server Analysis Services. Используйте этот параметр, чтобы указать сервер и экземпляр, на котором размещена Analysis Servicesная база данных.
/Analysisdatabasename.: Имя Необязательный параметр. Указывает имя базы данных Analysis Services, которую необходимо использовать с Azure DevOps Server, если на сервере имеется более одной такой базы данных, указанной с помощью параметра /аналисисинстанце .
/Preview Необязательный параметр. Отображает действия, которые необходимо выполнить для обновления конфигурации.
/континуе Необязательный параметр. Указывает, что команда ремапдб должна продолжаться, даже если при попытке разместить одну или несколько баз данных возникла ошибка. При использовании параметра /континуе все коллекции, базы данных которых не найдены на указанном сервере или серверах, будут перенастроены на использование сервера и экземпляра, на котором размещается база данных конфигурации.
/усесклалвайсон Необязательный параметр. Указывает, что базы данных входят в группу обеспечения доступности AlwaysOn в SQL Server. Если этот аргумент задан, в строке подключения задается параметр MultiSubnetFailover.

Дополнительные сведения см. в разделе группы доступности AlwaysOn (SQL Server).

Предварительные условия

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

Примечания

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

Пример

В следующем примере показано, как перенаправить Azure DevOps Server в конфигурацию TFS базы данных конфигурации _ . Эта база данных размещается в Контосомаин на именованном экземпляре Теамдатабасес. Базы данных коллекции проектов хранятся как в Контосомаин \ теамдатабасес, так и в экземпляре по умолчанию в contoso2.

TFSConfig RemapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
            /SQLInstances:ContosoMain\TeamDatabases,Contoso2

репаиржобкуеуе

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

TfsConfig repairJobQueue

Предварительные условия

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

Примечания

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

Пример

TfsConfig repairJobQueue

Доступность команды: TFS 2015

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

TfsConfig repairJobQueue

Предварительные условия

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

Примечания

Как правило, команда репаиржобкуеуе используется, если вы заметили, что запланированные задания не запущены.
Команда не принимает никаких аргументов и требует настройки развертывания 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]
Параметр Описание
публикурл Указывает URL-адрес сервера уровня приложений для Azure DevOps. Это значение хранится в базе данных конфигурации для Azure DevOps.

Предварительные условия

Вы должны быть членом группы безопасности "Администраторы DevOps Azure" и "Администраторы" на сервере уровня приложений. Дополнительные сведения см. в разделе Установка разрешений администратора для 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

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

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

TFSConfig Settings [/ServerURL:URL] [/NotificationURL:URL]
Параметр Описание
/Серверурл: URL-адрес Указывает URL-адрес сервера уровня приложений для Azure DevOps. Это значение хранится в базе данных конфигурации для Azure DevOps.
/Нотификатионурл: URL-адрес Указывает URL-адрес для использования в тексте оповещений электронной почты, если этот URL-адрес отличается от URL-адреса сервера уровня приложений для Azure DevOps. Это значение хранится в базе данных конфигурации.

Предварительные условия

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

Примечания

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

Пример

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

TFSConfig Settings /NotificationURL:http://contoso.example.com/tfs /ServerURL:http://contoso.example.com:8080/tfs

Настройка

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

TfsConfig setup /uninstall:<feature[,feature,...]>
Параметр Описание
uninstall Указывает один или несколько компонентов для удаления с компьютера, на котором выполняется команда. Возможные варианты: ALL, ApplicationTier, Search и VersionControlProxy.
Параметр Описание
/uninstall Указывает один или несколько компонентов для удаления с компьютера, на котором выполняется команда. Возможные варианты: ALL, ApplicationTier, Шарепоинтекстенсионс, Search, TeamBuild и VersionControlProxy.
Параметр Описание
/uninstall Указывает один или несколько компонентов для удаления с компьютера, на котором выполняется команда. Возможные варианты: ALL, ApplicationTier, Шарепоинтекстенсионс, TeamBuild, VersionControlProxy.

Предварительные условия

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

Примеры

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

TfsConfig setup /uninstall:ALL

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

TfsConfig setup /uninstall:ApplicationTier,TeamBuild

TCM

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

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
Параметр Описание
/упградетестпланс Требуется, если не используется /упградестатус .

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

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

Если в имени коллекции проектов есть пробелы, заключите его в кавычки, например, в " коллекцию Fabrikam Fiber " .
/Теампрожектнаме: имя_командного_проекта Обязательный. Указывает проект, для которого требуется перенести тестовые данные, или проверьте состояние миграции. Этот проект должен быть определен в коллекции, указанной с помощью параметра /CollectionName .

Если имя проекта содержит пробелы, заключите его в кавычки, например " My Project " .

Предварительные условия

Необходимо входить в группу безопасности {2>Администраторы Team Foundation<2} и быть администратором на сервере уровня приложений. См. раздел Установка разрешений администратора для Azure DevOps Server.

Примечания

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

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

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

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

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

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

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

Примеры

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

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

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

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
Параметр Описание
/упградетестпланс Требуется, если не используется /упградестатус .

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

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

Если в имени коллекции проектов есть пробелы, заключите его в кавычки, например, в " коллекцию Fabrikam Fiber " .
/Теампрожектнаме: имя_командного_проекта Обязательный. Указывает проект, для которого требуется перенести тестовые данные, или проверьте состояние миграции. Этот проект должен быть определен в коллекции, указанной с помощью параметра /CollectionName .

Если имя проекта содержит пробелы, заключите его в кавычки, например " My Project " .

Предварительные условия

Необходимо входить в группу безопасности {2>Администраторы Team Foundation<2} и быть администратором на сервере уровня приложений. См. раздел Установка разрешений администратора для Azure DevOps Server.

Примечания

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

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

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

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

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

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

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

Примеры

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

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

Unattend

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

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

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

Используйте параметр /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 можно вручную внести изменения в файл автоматической установки, используя любой редактор обычного текста. Это необходимо для некоторых входных типов, например сервицеаккаунтпассворд или персоналакцесстокен , так как эти значения секрета не могут быть заданы с помощью параметра /инпутс .
проверка Необязательный параметр. Задает выполнение настройки, в ходе которого выполняются только проверки, основанные на файле автоматической установки, входных данных и типе конфигурации. Это альтернатива выполнению полной настройки.
continue Необязательный параметр. Указывает, что параметры /create и /configure должны продолжать выполняться, невзирая на предупреждения проверок.
InstallType Описание
невсервербасик Настраивает базовые службы разработки для Azure DevOps Server. К ним относятся система управления версиями, рабочие элементы, сборка и возможность поиска.
невсерверадванцед Настраивает базовые службы разработки и разрешает необязательную настройку интеграции с Reporting Services.
Обновление Обновляет Azure DevOps Server до текущей версии из поддерживаемого предыдущего выпуска.
препродуктионупграде Протестируйте обновление на существующем Azure DevOps Server развертывании в подготовительной среде. Обычно это делается с помощью баз данных, восстановленных из рабочей резервной копии. Этот сценарий включает дополнительные шаги, которые гарантируют, что новое развертывание не будет мешать рабочему развертыванию.
аппликатионтиеронлибасик Настройте новый уровень приложения, используя существующие параметры из указанной базы данных конфигурации. Этот параметр позволяет быстро настроить и запустить новый уровень приложения с помощью существующих параметров. Если вы хотите изменить существующие параметры, используйте вместо него расширенный тип Аппликатионтиеронлядванцед.
аппликатионтиеронлядванцед Настройте новый уровень приложения с полным контролем над всеми параметрами. По умолчанию параметры будут иметь существующие значения из указанной базы данных конфигурации. Если вы хотите сохранить все существующие параметры, используйте вместо него тип Аппликатионтиеронлибасик.
Клонировать Настройте новое развертывание Azure DevOps Server, которое является клоном существующего развертывания. Обычно это делается с помощью баз данных, восстановленных из рабочей резервной копии, для создания среды, в которой можно тестировать изменения конфигурации, расширения и другие изменения. Этот сценарий включает дополнительные шаги, которые гарантируют, что новое развертывание не будет мешать рабочему развертыванию.
Proxy (Прокси) Настраивает службу прокси-сервера системы управления версиями.

Предварительные условия

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

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

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

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

Примеры

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

Важно!

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

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

Доступность команды: TFS 2018, TFS 2017, TFS 2015, TFS 2013

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

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

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

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

TFSConfig unattend /create|unattend /type:InstallType /unattendfile:ConfigurationFileName [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]
Параметр Описание
/CREATE Создает файл автоматической установки с указанным именем и параметрами.
/configure Настраивает Azure DevOps Server с помощью файла автоматической установки и указанных вами параметров. Для этого параметра необходимо использовать/Type или/unattendfile..
/Type: инсталлтипе

Указывает тип используемой конфигурации.

  • Базовый: настраивает Azure DevOps Server в базовой конфигурации, включая SQL Server Express.

  • Стандартный: настраивает Azure DevOps Server в стандартной конфигурации с одним сервером.

  • Атонли: настраивает дополнительный уровень приложений для существующего развертывания Azure DevOps Server.

  • Build: настраивает службу сборок Team Foundation.

  • Прокси: Настраивает прокси-сервер Azure DevOps.

  • Установка: устанавливает и настраивает SharePoint Foundation 2013 для использования с Azure DevOps Serverным развертыванием.

  • Обновление: обновляет предыдущую версию Azure DevOps Server до последней версии программного обеспечения.

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

  • Расширения: настраивает расширения SharePoint для Azure DevOps Server.

При использовании параметра /configure требуется указать параметр /type или /unattendfile, но не оба.

/unattendfile.: конфигуратионфиленаме Задает создаваемый или используемый файл автоматической установки, а также исходный параметр —/create или /configure. При использовании параметра /configure необходимо указать параметр /unattendfile или /type.
/инпутс: key1 = значение1; Key2 = значение2;... Необязательный параметр. Параметр /create (если используется) задает параметры и значения, которые будут использоваться при создании файла автоматической установки. Параметр /configure (если используется) задает дополнительные параметры и значения, которые будут использоваться совместно с файлом автоматической установки.

В качестве альтернативы использованию параметра /inputs можно вручную внести изменения в файл автоматической установки, используя любой редактор обычного текста. Это необходимо для некоторых входных типов, например сервицеаккаунтпассворд или персоналакцесстокен , так как эти значения секрета не могут быть заданы с помощью параметра /инпутс .
/Verify Необязательный параметр. Задает выполнение настройки, в ходе которого выполняются только проверки, основанные на файле автоматической установки, входных данных и типе конфигурации. Это альтернатива выполнению полной настройки.
/континуе Необязательный параметр. Указывает, что параметры /create и /configure должны продолжать выполняться, невзирая на предупреждения проверок.
/? Необязательный параметр. Выводит справку командной строки для команд автоматической установки.

Предварительные условия

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

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

Примечания

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

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

Примеры

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

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

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

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

Внимание!
В этом примере после создания файла автоматической установки администратор вручную вносит изменения в файл, чтобы указать пароль для учетной записи службы сборки. При добавлении пароля в качестве входных данных с помощью " сервицеаккаунтпассворд = password " данные пароля не добавляются в файл.

TFSConfig Unattend /create /type:build /unattendfile:configTFSBuild.ini
        /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig
        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

Вторая команда возвращает следующие сведения, включая имя сервера, где была настроена сборка Team Foundation (Фабрикамфибертфс), и коллекцию проектов, связанную с контроллером (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

зиплогс

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

TfsConfig Зиплогс

TfsConfig zipLogs

Устаревшие команды

Лицензия

С помощью команды License можно отобразить, изменить или расширить ключ лицензирования для развертывания Azure DevOps Server.

TFSConfig License [/ProductKey:Key] [/extend [NewTrialID]]
Параметр Описание
/ProductKey: Раздел Указывает, что ключ лицензии для развертывания будет обновлен со значением Key.
/екстенд Указывает, что пробный период лицензирования для Azure DevOps Server будет продлен на 30 дней. Этот параметр можно использовать только один раз без получения нового идентификатора пробной версии. Если требуется второе расширение, необходимо получить вторую пробную лицензию от корпорации Майкрософт.

Предварительные условия

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

Примечания

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

Примеры

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

TFSConfig License

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright © Microsoft Corporation. All rights reserved.
    Team Foundation Server Standard license
    The following features are installed:
    Team Foundation Server
    Build Services
    Build: 21106.00
    Product ID: 01234-567-8910
    Trial license with 74 days remaining, expiring on 6/30/2010
    Trial ID: ABCD-EFGH-IJKL

TCM

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

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
Параметр Описание
/упградетестпланс Требуется, если не используется /упградестатус .

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

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

Если в имени коллекции проектов есть пробелы, заключите его в кавычки, например, в " коллекцию Fabrikam Fiber " .
/Теампрожектнаме: имя_командного_проекта Обязательный. Указывает проект, для которого требуется перенести тестовые данные, или проверьте состояние миграции. Этот проект должен быть определен в коллекции, указанной с помощью параметра /CollectionName .

Если имя проекта содержит пробелы, заключите его в кавычки, например " My Project " .

Предварительные условия

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

Примечания

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

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

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

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

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

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

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

Примеры

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

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

Импорт

Команда импорта устарела в TFS 2013. Более ранние версии доступны здесь:

Если вам нужна помощь с обновлением данных и проектов из более ранней версии Azure DevOps Server, см. статью обновление Azure DevOps Serverили обратитесь в Служба поддержки Майкрософт.

препарескл

Команда Препарескл была прекращена в TFS 2012. Более ранние версии доступны здесь:

Восстановить

Команда Repair была прекращена в TFS 2012. Более ранние версии доступны здесь:

Если необходимо восстановить хранимые процедуры после обновления базы данных с ошибкой, обратитесь в Служба поддержки Майкрософт.

Диагностика

Команда диагностики устарела в TFS 2013. Более ранние версии доступны здесь:

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

Обновления

Команда Updates устарела в TFS 2013. более ранние версии доступны здесь:

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

PrepareClone

Команда PrepareClone устарела в TFS 2017.

Команда PrepareClone удаляет сведения о запланированных резервных копиях, SharePoint и ресурсах отчетов из развертывания Azure DevOps Server. Эта команда используется в двух случаях:

  • Когда вы перемещаете развертывание на новое оборудование, но хотите использовать старое развертывание
  • При клонировании Azure DevOps Server развертывания

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

Важно!

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

TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:TFSConfigurationDatabaseName
        [/notificationURL: TFSURL] [/usesqlalwayson]
Параметр Действие
/DatabaseName Указывает имя сервера, на котором размещена база данных, которая будет сопоставлена Azure DevOps Server, в дополнение к имени самой базы данных конфигурации.
/SQLInstance: Имя Указывает имя сервера, который необходимо преобразовать в качестве сервера, на котором размещается одна или несколько баз данных для Azure DevOps Server. Если экземпляр, на котором размещается база данных, отличается от экземпляра по умолчанию, также необходимо указать его имя. Используйте следующий формат: ServerName < /strong > instanceName.
/Нотификатионурл: тфсурл Необязательный параметр. Указывает URL-адрес уведомления для сервера уровня приложений.
/усесклалвайсон Необязательный параметр. Указывает, что базы данных входят в группу обеспечения доступности AlwaysOn в SQL Server. Если этот аргумент задан, в строке подключения задается параметр MultiSubnetFailover.

Дополнительные сведения см. в разделе группы доступности AlwaysOn (SQL Server).

Предварительные условия

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

Примечания

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

Пример

В следующем примере показано, как использовать команду на перемещенном Azure DevOps Server с именем Невфабрикамтфс для удаления старых резервных копий, отчетов и сведений о ресурсах SharePoint. Если эта информация не удаляется, исходное развертывание Azure DevOps Server по-прежнему использует те же ресурсы и базы данных, которые будут повреждены. В этом примере SQL Server, поддерживающая перемещенный Azure DevOps Server, также называется Невфабрикамтфс, а экземпляр — экземпляром по умолчанию, поэтому конкретные сведения об экземпляре не требуются, просто имя сервера.

TFSConfig PrepareClone /SQLInstance:NewFabrikamTFS /DatabaseName:TFS_Configuration

Лицензия

С помощью команды License можно отобразить, изменить или расширить ключ лицензирования для развертывания Azure DevOps Server.

TFSConfig License [/ProductKey:Key] [/extend [NewTrialID]]
Параметр Описание
/ProductKey: Раздел Указывает, что ключ лицензии для развертывания будет обновлен со значением Key.
/екстенд Указывает, что пробный период лицензирования для Azure DevOps Server будет продлен на 30 дней. Этот параметр можно использовать только один раз без получения нового идентификатора пробной версии. Если требуется второе расширение, необходимо получить вторую пробную лицензию от корпорации Майкрософт.

Предварительные условия

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

Примечания

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

Примеры

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

TFSConfig License

TFSConfig - Team Foundation Server Configuration Tool
Copyright © Microsoft Corporation. All rights reserved.
Team Foundation Server Standard license
The following features are installed:
Team Foundation Server
Build Services
Build: 21106.00
Product ID: 01234-567-8910
Trial license with 74 days remaining, expiring on 6/30/2010
Trial ID: ABCD-EFGH-IJKL
TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
Параметр Описание
/упградетестпланс Требуется, если не используется /упградестатус .

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

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

Если в имени коллекции проектов есть пробелы, заключите его в кавычки, например, в " коллекцию Fabrikam Fiber " .
/Теампрожектнаме: имя_командного_проекта Обязательный. Указывает проект, для которого требуется перенести тестовые данные, или проверьте состояние миграции. Этот проект должен быть определен в коллекции, указанной с помощью параметра /CollectionName .

Если имя проекта содержит пробелы, заключите его в кавычки, например " My Project " .

Предварительные условия

Необходимо входить в группу безопасности {2>Администраторы Team Foundation<2} и быть администратором на сервере уровня приложений. См. раздел Установка разрешений администратора для Team Foundation Server.

Примечания

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

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

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

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

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

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

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

Примеры

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

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

Импорт

Команда импорта устарела в TFS 2013. Более ранние версии доступны здесь:

Если вам нужна помощь с обновлением данных и проектов из более ранней версии Azure DevOps Server, см. статью обновление Azure DevOps Serverили обратитесь в Служба поддержки Майкрософт.

препарескл

Команда Препарескл была прекращена в TFS 2012. Более ранние версии доступны здесь:

Восстановить

Команда Repair была прекращена в TFS 2012. Более ранние версии доступны здесь:

Если необходимо восстановить хранимые процедуры после обновления базы данных с ошибкой, обратитесь в Служба поддержки Майкрософт.

Диагностика

Команда диагностики устарела в TFS 2013. Более ранние версии доступны здесь:

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

Обновления

Команда Updates устарела в TFS 2013. Более ранние версии доступны здесь:

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

PrepareClone

Команда PrepareClone устарела в TFS 2017.

Доступность команды: TFS 2015 и TFS 2013

Команда PrepareClone удаляет сведения о запланированных резервных копиях, SharePoint и ресурсах отчетов из развертывания Azure DevOps Server. Эта команда используется в двух случаях:

  • Когда вы перемещаете развертывание на новое оборудование, но хотите использовать старое развертывание
  • При клонировании Azure DevOps Server развертывания

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

Внимание!
Эту команду следует выполнять перед настройкой, независимо от того, перемещаете или копируете Azure DevOps Server. Если вы запустите его после настройки, вы могли бы привести к несогласованности содержимого в базах данных и содержимого в файле web.config. Эти несоответствия могут перевести сервер в автономный режим. Если вы уже настроили перемещенное или клонированное развертывание Azure DevOps Server и поняли, что вам нужно выполнить команду, выполните следующие действия. Прежде всего, заморозьте сервер. Затем последовательно выполните команды PrepareClone, ChangeServerID и RemapDBs. После этого разморозьте сервер.

TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:TFSConfigurationDatabaseName
    [/notificationURL: TFSURL] [/usesqlalwayson]
Параметр Действие
/DatabaseName Указывает имя сервера, на котором размещена база данных, которая будет сопоставлена Azure DevOps Server, в дополнение к имени самой базы данных конфигурации.
/SQLInstance: Имя Указывает имя сервера, который необходимо преобразовать в качестве сервера, на котором размещается одна или несколько баз данных для Azure DevOps Server. Если экземпляр, на котором размещается база данных, отличается от экземпляра по умолчанию, также необходимо указать его имя. Используйте следующий формат: ServerName < /strong > instanceName.
/Нотификатионурл: тфсурл Необязательный параметр. Указывает URL-адрес уведомления для сервера уровня приложений.
/усесклалвайсон Необязательный параметр. Указывает, что базы данных входят в группу обеспечения доступности AlwaysOn в SQL Server. Если этот аргумент задан, в строке подключения задается параметр MultiSubnetFailover.

Дополнительные сведения см. в разделе группы доступности AlwaysOn (SQL Server).

Предварительные условия

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

Примечания

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

Пример

В следующем примере показано, как использовать команду на перемещенном Azure DevOps Server с именем Невфабрикамтфс для удаления старых резервных копий, отчетов и сведений о ресурсах SharePoint. Если эта информация не удаляется, исходное развертывание Azure DevOps Server по-прежнему использует те же ресурсы и базы данных, которые будут повреждены. В этом примере SQL Server, поддерживающая перемещенный Azure DevOps Server, также называется Невфабрикамтфс, а экземпляр — экземпляром по умолчанию, поэтому конкретные сведения об экземпляре не требуются, просто имя сервера.

TFSConfig PrepareClone /SQLInstance:NewFabrikamTFS /DatabaseName:TFS_Configuration