Команда ConfigureConnections

Статья
11/05/2008

Обновлен: Ноябрь 2007

Команда ConfigureConnections используется для изменения интерфейса подключения для Team Foundation Server.

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

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

Необходимые разрешения

Чтобы использовать команду ConfigureConnections, необходимо быть членом группы безопасности Администраторы Team Foundation на сервере уровня приложений Team Foundation и членом группы безопасности sysadmin для SQL Server на сервере уровня данных Team Foundation. Если используется параметр /proxy, необходимо быть администратором на серверах уровня приложений и прокси-серверах для Team Foundation. Дополнительные сведения см. в разделе Разрешения Team Foundation Server.

Примечание.
Даже если вход в систему выполнен с учетными данными администратора, необходимо открыть окно командной строки с повышенными правами, чтобы выполнить эту функцию на сервере под управлением Windows Server 2008. Чтобы открыть окно командной строки с повышенными правами, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора. Дополнительные сведения см. на веб-узле корпорации Майкрософт.

Даже если вход в систему выполнен с учетными данными администратора, необходимо открыть окно командной строки с повышенными правами, чтобы выполнить эту функцию на сервере под управлением Windows Server 2008. Чтобы открыть окно командной строки с повышенными правами, нажмите кнопку Пуск, щелкните правой кнопкой мыши пункт Командная строка и выберите команду Запуск от имени администратора. Дополнительные сведения см. на веб-узле корпорации Майкрософт.

TFSAdminUtil ConfigureConnections [/View] [/proxy] [/ClientCertificate :(user|computer)] [/ATUri:<uri>] [/PublicATUri:<uri>] [/SharepointUri:<uri>] [/SharepointSitesUri:<uri>] [/SharepointAdminUri:<uri>] [/SharepointUnc:<unc>] [/ReportsUri:<uri>] [/ReportServerUri:<uri>] [/TswaUri:<uri>]

Параметры

Аргумент	Описание
user	С помощью параметра /clientcertificate можно задать использование хранилища сертификатов пользователей.
computer	С помощью параметра /clientcertificate можно задать использование хранилища сертификатов компьютеров.
URI	Используется, чтобы задать универсальный код ресурса (URI) с соответствующим параметром.

Параметр	Описание
/view	Отображает текущие настройки подключения для Team Foundation Server.
/proxy	Запускает команду для учетной записи-посредника Team Foundation Server. Если применяется параметр /proxy, может использоваться только параметр /clientcertificate.
/ClientCertificate	Задает хранилище сертификатов пользователей или компьютеров, к которому необходимо добавить сертификат.
/ATUri	Задает универсальный код ресурса (URI) уровня приложений.
/PublicATUri	Задает универсальный код ресурса (URI) для текста оповещения по электронной почте.
/SharepointSitesUri	Задает универсальный код ресурса (URI) для веб-узла SharePoint.
/SharepointAdminUri	Задает универсальный код ресурса (URI) для административного узла SharePoint.
/SharepointUnc	Задает путь UNC к SharePoint.
/ReportsUri	Задает универсальный код ресурса (URI) для служб отчетов SQL Server. С этого веб-узла можно просмотреть отдельные отчеты Team Foundation Server.
/ReportServerUri	Задает универсальный код ресурса (URI) для веб-службы ReportService.asmx.
/TswaUri	Задает универсальные коды ресурса (URI) для различных компонентов Team System Web Access, если данный продукт установлен.

Заметки

Важное примечание.
Рекомендуется создавать резервные копии баз данных на сервере уровня данных Team Foundation Server перед запуском команды ConfigureConnections. Также рекомендуется запускать команду, используя параметр /view, чтобы сначала просмотреть существующие настройки.

Рекомендуется создавать резервные копии баз данных на сервере уровня данных Team Foundation Server перед запуском команды ConfigureConnections. Также рекомендуется запускать команду, используя параметр /view, чтобы сначала просмотреть существующие настройки.

С помощью команды ConfigureConnections администратор может изменить сведения о конфигурации, такие как имя сервера или номер порта, для одного или нескольких компонентов Team Foundation Server. Администратор запускает данный инструмент из уровня приложений, чтобы обновить все серверы Team Foundation с новыми данными конфигурации.

Служебная программа обновляет данные конфигурации следующим образом:

Параметр /ATUri настраивает данные конфигурации в файле веб-служб web.config, файле CoverAn.exe.config, файле TFSServerScheduler.exe.config и базе данных Team Foundation.
Параметр /PublicATUri настраивает данные конфигурации в файле веб-служб web.config.
Параметр /ClientCertificate открывает хранилище сертификатов для пользователя или компьютера, в зависимости от аргумента. После того как пользователь указал используемый сертификат, данные записываются в файл веб-служб web.config, файл CoverAn.exe.config и файл TFSServerScheduler.exe.config.
Параметры /SharePointUri/SharepointSitesUri, /SharePointUnc и /SharepointAdminUri настраивают данные конфигурации SharePoint (продукты и технологии) в базе данных Team Foundation.
Параметры /Reports и /ReportServer настраивают данные конфигурации служб отчетов SQL Server в базе данных Team Foundation.
Параметр /TswaUri настраивает данные конфигурации Team System Web Access, если данный компонент установлен.

Команда ConfigureConnections не очищает кэш на клиентских компьютерах, чтобы данные компьютеры могли использовать новые данные конфигурации для компонентов Team Foundation Server. Очистите кэш клиентских компьютеров вручную, чтобы они могли использовать новые данные конфигурации.

Очистка кэша на клиентском компьютере Team Foundation

Войдите на клиентский компьютер, используя учетные данные пользователя, чью учетную запись необходимо обновить, и закройте все открытые экземпляры Visual Studio.
Откройте веб-обозреватель и перейдите в одну из следующих папок, расположение которой зависит от операционной системы, под управлением которой работает клиентский компьютер.
- Windows XP или Windows Server 2003
  
  Диск**:\Documents and Settings\имя_пользователя\Local Settings\Application Data\Microsoft\Team Foundation\2.0\Cache**
- Windows Vista
  
  Диск**:\Users\имя_пользователя\Application Data\Local\Microsoft\Team Foundation\2.0\Cache**
Удалите содержимое каталога кэша, включая все подпапки.

Повторите эти шаги для каждой учетной записи пользователя на компьютере с доступом к Team Foundation Server.

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

Пример

В следующем примере отображаются текущие значения параметров ATUri, PublicATUri, SharepointUri, SharepointSitesUri, SharepointAdminUri, SharepointUnc, ReportsUri, ReportServerUri и TswaUri. Если значение не задано, параметр вывода показывает, что значение не было задано.

>TFSAdminUtil ConfigureConnections /view

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

>TFSAdminUtil ConfigureConnections /PublicATUri:http://contoso.example.com:8080

См. также

Другие ресурсы

Использование средств командной строки Team Foundation Server

Администрирование Team Foundation Server

Управление службами и учетными записями служб сервера Team Foundation Server

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