ChangeServerID (Comando)

El comando ChangeServerID cambia los identificadores únicos globales (GUID) que están asociados a las bases de datos de Visual Studio Team Foundation Server (TFS).Los GUID deben ser únicos dentro de una implementación de TFS).Si más de una base de datos tiene el mismo GUID, su implementación puede volverse inestable o inutilizable.Puede cambiar el GUID para la base de datos de configuración, los GUID para todas las bases de datos de la colección de proyectos de equipo en la implementación, o ambos.Aunque no usaría normalmente este comando en operaciones cotidianas, podría usarlo en las siguientes circunstancias:

  • Ha restaurado su implementación al nuevo hardware, la implementación anterior todavía está operativa y desea usar ambas implementaciones.Este escenario se conoce a veces como clonar el servidor.

  • Desea probar una actualización de software o una configuración de hardware en una implementación duplicada sin riesgo de interrupción del entorno de producción.

  • Si desea probar totalmente la restauración de bases de datos al nuevo hardware en un laboratorio de pruebas o entorno independiente, asegúrese de que se puede restaurar su implementación.

  • Debe restablecer el GUID para una base de datos de colección después de moverlo a otra implementación para la que ya está reservado ese GUID.

    [!NOTA]

    El comando ChangeServerID no es reversible.Una vez cambiado un GUID, no se puede deshacer ese cambio excepto al restaurar una versión anterior de esa base de datos.

Permisos necesarios

Para usar el comando ChangeServerID, debe ser miembro del grupo de seguridad Administradores de Team Foundation y miembro del grupo de seguridad sysadmin para cualquier base de datos de SQL Server que Team Foundation Server utilice.Para obtener más información, vea Permisos de Team Foundation Server.

[!NOTA]

Incluso si inicia una sesión con credenciales administrativas, debe abrir una ventana de símbolo del sistema con privilegios elevados para realizar esta función.

TFSConfig ChangeServerID /SQLInstance:ServerName] /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly] [/usesqlalwayson]

Parámetros

marcador de posición

Descripción

ServerName

Especifica el nombre del servidor que hospeda la base de datos de configuración de TFS y el nombre de la instancia si desea utilizar una instancia distinta de la predeterminada.Si especifica una instancia, debe usar el siguiente formato:

NombreDeServidor\NombreDeInstancia

DatabaseName

Especifica el nombre de la base de datos de configuración.De manera predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB.

Opción

Descripción

/SQLInstance:ServerName

Requerido.Especifica el nombre del servidor que está ejecutando SQL Server y el nombre de la instancia si desea utilizar una instancia distinta de la instancia predeterminada.Si especifica una instancia, debe usar el siguiente formato:

NombreServidor\NombreInstancia

/DatabaseName:DatabaseName

Requerido.Especifica el nombre de la base de datos de configuración para TFS.

/ProjectCollectionsOnly

Especifica que solo se modificarán los GUID de las colecciones.

/ConfigDBOnly

Especifica que solo se modificará el GUID de la base de datos de configuración.

/usesqlalwayson

Especifica que las bases de datos forman parte del grupo de disponibilidad AlwaysOn de SQL Server.Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, vea Grupos de disponibilidad AlwaysOn (SQL Server).

Comentarios

Use el comando ChangeServerID para crear un duplicado discreto de una implementación de Team Foundation Server con fines de prueba o clonación.Después de usar el comando ChangeServerID, debe dirigir los clientes para crear una conexión al servidor cambiado antes de que se pueda usar.

Ejemplo

En el ejemplo siguiente se muestra cómo cambiar los GUID de todas las bases de datos en la implementación de Contoso1 de TFS, donde la base de datos de configuración se hospeda en el servidor que se denomina "ContosoMain" en la instancia con nombre "TeamDatabases" de SQL Server.

[!NOTA]

Los ejemplos tienen solo propósitos ilustrativos y son ficticios.No se pretende ni se deduce ninguna asociación real.

TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

Vea también

Tareas

Move a Team Project Collection

Split a Team Project Collection

Conceptos

Hacer copias de seguridad y restaurar la implementación

Otros recursos

Administrar la configuración del servidor con TFSConfig