ChangeServerID-Befehl

Der ChangeServerID-Befehl ändert die eindeutigen Bezeichner (GUIDs), die den Datenbanken für Visual Studio Team Foundation Server (TFS) zugeordnet sind.GUIDs müssen innerhalb einer Bereitstellung von TFS eindeutig sein.Wenn mehr als eine Datenbank die gleiche GUID hat, kann die Bereitstellung instabil oder unbrauchbar werden.Sie können die GUID für die Konfigurationsdatenbank ändern, die GUIDs für alle Teamprojektsammlungsdatenbanken in der Bereitstellung oder beides.Obwohl Sie diesen Befehl in täglichen Operationen in der Regel nicht verwenden würden, könnten Sie diesen Befehl in den folgenden Umständen verwenden:

• Sie haben die Bereitstellung auf neuer Hardware wiederhergestellt, die alte Bereitstellung ist immer noch funktionstüchtig, und Sie möchten beide Bereitstellungen verwenden.Dieses Szenario wird manchmal als Klonen des Servers bezeichnet.

• Sie möchten ein Softwareupdate oder eine Hardwarekonfiguration in einer doppelten Bereitstellung testen, um keine Störung der Produktionsumgebung zu riskieren.

• Sie möchten die Wiederherstellung von Datenbanken auf neuer Hardware in einer Testumgebung oder in einer separaten Umgebung umfassend testen, um sicherzustellen, dass die Bereitstellung wiederhergestellt werden kann.

• Sie müssen die GUID für eine Auflistungsdatenbank zurücksetzen, nachdem Sie sie in eine andere Bereitstellung verschoben haben, für die diese GUID bereits reserviert ist.

  Hinweis
  Der Befehl ChangeServerID ist nicht umkehrbar.Nachdem eine GUID geändert wurde, können Sie diese Änderung nur rückgängig machen, indem Sie eine frühere Version dieser Datenbank wiederherstellen.

Erforderliche Berechtigungen

Zum Verwenden des ChangeServerID-Befehls müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren und der Sicherheitsgruppe sysadmin für alle SQL Server-Datenbanken sein, die von Team Foundation Server verwendet werden.Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

Hinweis
Sie müssen auch dann ein Fenster für erweiterte Eingabeaufforderung öffnen, wenn Sie sich mit Administratoranmeldeinformationen anmelden, um diese Funktion auszuführen.

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

Parameter

Platzhalter	Beschreibung
ServerName	Gibt den Namen des Servers an, der die Konfigurationsdatenbank für TFS hostet, und den Namen der Instanz, wenn Sie eine von der Standardinstanz abweichende Instanz verwenden.Wenn Sie eine Instanz angeben, muss das folgende Format verwendet werden: Servername\Instanzname
DatabaseName	Gibt den Namen der Konfigurationsdatenbank an.Standardmäßig lautet der Name dieser Datenbank TFS_ConfigurationDB.

Option	Beschreibung
/SQLInstance:ServerName	Erforderlich.Gibt den Namen des Servers an, auf dem SQL Server ausgeführt wird, sowie den Namen der Instanz, wenn Sie nicht die Standardinstanz verwenden möchten.Wenn Sie eine Instanz angeben, muss das folgende Format verwendet werden: Servername\Instanzname
/DatabaseName:DatabaseName	Erforderlich.Gibt den Namen der Konfigurationsdatenbank für TFS an.
/ProjectCollectionsOnly	Gibt an, dass nur die GUIDs für Auflistungen geändert werden.
/ConfigDBOnly	Gibt an, dass nur die GUID für die Konfigurationsdatenbank geändert wird.
/usesqlalwayson	Gibt an, dass die Datenbanken in SQL Server Teil einer AlwaysOn-Verfügbarkeitsgruppe sind.Wenn diese Option konfiguriert, legt sie MultiSubnetFailover in der Verbindungszeichenfolge fest. Weitere Informationen finden Sie unter AlwaysOn-Verfügbarkeitsgruppen (SQL Server).

Hinweise

Sie verwenden den ChangeServerID-Befehl, um ein einzelnes Duplikat einer Bereitstellung von Team Foundation Server für Tests oder zum Klonen zu erstellen.Nachdem Sie den ChangeServerID-Befehl verwendet haben, müssen Sie Clients anweisen, eine Verbindung mit dem geänderten Server zu erstellen, bevor er verwendet werden kann.

Beispiel

Im folgenden Beispiel wird gezeigt, wie die GUIDs aller Datenbanken in der Contoso1-Bereitstellung von TFS, auf der die Konfigurationsdatenbank auf dem Server "ContosoMain" in der benannten Instanz "TeamDatabases" in SQL Server gehostet wird, geändert werden.

Hinweis
Die Beispiele dienen nur zu Illustrationszwecken und sind frei erfunden.Ähnlichkeiten mit real existierenden Personen oder Gegebenheiten sind rein zufällig und nicht beabsichtigt.

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

Siehe auch

Aufgaben

Move a Team Project Collection

Split a Team Project Collection

Konzepte

Sichern und Wiederherstellen der Bereitstellung

Weitere Ressourcen

Verwalten der Serverkonfiguration mit TFSConfig