Команда ChangeServerID
С помощью команды ChangeServerID можно изменить GUID, связанные с базами данных для Visual Studio Team Foundation Server (TFS).Идентификаторы GUID должны быть уникальны в пределах развертывания TFS.Если более чем одна база данных имеет одинаковый идентификатор GUID, развертывание может стать нестабильным или непригодным для использования.Можно изменить идентификатор GUID для базы данных конфигурации, идентификаторы GUID для всех баз данных коллекции командных проектов в развертывании или оба вида идентификаторов.Несмотря на то, что эта команда обычно не используется в ежедневных операциях, эту команду можно использовать в следующих случаях:
Если при восстановлении развертывания на новом оборудовании (старое развертывание продолжает функционировать) необходимо использовать оба развертывания.Этот сценарий иногда называют клонированием на сервере.
Допустим, необходимо проверить обновление программного обеспечения или конфигурацию оборудования на дубликате развертывания, не создавая риск нарушения работы производственной среды.
Чтобы гарантировать возможность восстановления развертывания, нужно выполнить полное тестирование восстановления базы данных для нового оборудования в тестовой лаборатории или отдельных условиях.
Необходимо сбросить идентификатор GUID для базы данных коллекции после перемещения его в другое развертывание, для которого этот идентификатор GUID уже зарезервирован.
Примечание Команда ChangeServerID необратима.После изменения идентификатора GUID это изменение отменить нельзя, за исключением восстановления предыдущей версии этой базы данных.
Необходимые разрешения
Для использования команды ChangeServerID необходимо быть членом группы безопасности Администраторы Team Foundation и членом группы безопасности sysadmin для всех баз данных SQL Server, используемых Team Foundation Server.Дополнительные сведения см. в разделе Разрешения Team Foundation Server.
Примечание |
---|
Даже если вход в систему выполнен с учетными данными администратора, чтобы выполнить эту функцию, необходимо открыть окно командной строки с повышенными привилегиями. |
TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly] [/usesqlalwayson]
Параметры
Заполнитель |
Описание |
---|---|
ServerName |
Указывает имя сервера, на котором размещены базы данных конфигурации для TFS, и, если требуется использовать экземпляр, отличный от экземпляра по умолчанию, имя экземпляра.Если задается экземпляр, необходимо использовать следующий формат: имя_сервера\имя_экземпляра |
DatabaseName |
Указывает имя базы данных конфигурации.По умолчанию для этой базы данных используется имя TFS_ConfigurationDB. |
Параметр |
Описание |
---|---|
/SQLInstance:ServerName |
Обязательное.Указывает имя сервера, на котором работает SQL Server, и, если используется экземпляр, отличный от экземпляра по умолчанию, имя экземпляра.Если задается экземпляр, необходимо использовать следующий формат: Имя_сервера\Имя_экземпляра |
/DatabaseName:DatabaseName |
Обязательное.Указывает имя базы данных конфигурации для TFS. |
/ProjectCollectionsOnly |
Указывает, что GUID будут изменены только для коллекций. |
/ConfigDBOnly |
Указывает, что GUID будет изменен только для базы данных конфигурации. |
/usesqlalwayson |
Указывает, что базы данных являются частью групп обеспечения доступности AlwaysOn в SQL Server.Если настроено, этот параметр задает MultiSubnetFailover в строке подключения. Дополнительные сведения см. в разделе Группы обеспечения доступности AlwaysOn (SQL Server). |
Заметки
Команда ChangeServerID используется для создания дискретных дубликатов развертывания Team Foundation Server с целью тестирования или клонирования.После использования команды ChangeServerID необходимо указать клиентам, чтобы они создали подключение к измененному серверу, прежде чем его можно будет использовать.
Пример
В следующем примере демонстрируется изменение идентификаторов GUID всех баз данных в развертывании Contoso1 для TFS, в котором базы данных конфигурации размещается на сервере с именем "ContosoMain"на именованном экземпляре "TeamDatabases"в SQL Server.
Примечание |
---|
Примеры приводятся только для иллюстрации и являются вымышленными.Реальная ассоциация не подразумевается. |
TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB
См. также
Задачи
Move a Team Project Collection
Split a Team Project Collection
Основные понятия
Резервное копирование и восстановление развернутых продуктов
Другие ресурсы
Управление конфигурацией сервера с помощью средства TFSLabConfig