Freigeben über


ChangeServerID-Befehl

Sie können die eindeutigen Bezeichner (GUIDS), die den Datenbanken für Visual Studio Team Foundation Server zugeordnet sind, mithilfe des ChangeServerID-Befehls ändern. GUIDs müssen innerhalb einer Bereitstellung von Team Foundation Server 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 auf einer doppelten Bereitstellung ein Softwareupdate oder eine Hardwarekonfiguration testen, damit Sie nicht riskieren, die Produktionsumgebung zu stören.

  • 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 die GUID bereits reserviert ist.

    Tipp

    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 hierzu finden Sie unter Team Foundation Server-Berechtigungen.

Tipp

Sie müssen auch dann eine Eingabeaufforderung mit erhöhten Rechten öffnen, wenn Sie sich mit Administratoranmeldeinformationen anmelden, um diese Funktion auf einem Server auszuführen, auf dem Windows Server 2008 ausgeführt wird. Klicken Sie zum Öffnen eines Eingabeaufforderungsfensters mit erhöhten Rechten auf Start, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. Weitere Informationen finden Sie auf der folgenden Seite auf der Microsoft-Website: Benutzerkontensteuerung.

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

Parameter

Platzhalter

Beschreibungen

ServerName

Gibt den Namen des Servers an, der die Konfigurationsdatenbank für Team Foundation Server und den Namen der Instanz hostet, 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

Beschreibungen

/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\InstanceName

/DatabaseName:DatabaseName

Erforderlich. Gibt den Namen der Konfigurationsdatenbank für Team Foundation Server an.

/ProjectCollectionsOnly

Gibt an, dass nur die GUIDs für Sammlungen geändert werden.

/ConfigDBOnly

Gibt an, dass nur die GUID für die Konfigurationsdatenbank geändert wird.

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 zum 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 Team Foundation Server, auf der die Konfigurationsdatenbank auf dem Server "ContosoMain" auf der benannten Instanz "TeamDatabases" in SQL Server gehostet wird, geändert werden.

Tipp

Die in den Beispielen verwendeten Firmen, Organisationen, Produkte, Domänennamen, E-Mail-Adressen, Logos, Personen, Orte und Ereignisse sind frei erfunden. Jede Ähnlichkeit mit bestehenden Firmen, Organisationen, Produkten, Domänennamen, E-Mail-Adressen, Logos, Personen, Orten oder Ereignissen ist rein zufällig.

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

Siehe auch

Aufgaben

Verschieben einer Teamprojektsammlung

Teilen einer Teamprojektsammlung

Konzepte

Sichern und Wiederherstellen der Bereitstellung

Weitere Ressourcen

Verwalten der Serverkonfiguration mit TFSConfig