Befehl "RenameDT"

Artikel
08/20/2008

Aktualisiert: November 2007

Verwenden Sie RenameDT, um den Namen des Datenebenenservers für Team Foundation Server zu ändern.

Wichtiger Hinweis:
Damit der RenameDT-Befehl erfolgreich ausgeführt werden kann, müssen die folgenden Anwendungspools und Programme ausgeführt werden.

Microsoft Team Foundation Server-Anwendungspool (Anwendungspool)
ReportServer (Anwendungspool)

Hinweis:

Der ReportServer-Anwendungspool wird bei SQL Server 2005 in Internetinformationsdienste (IIS) verwaltet, nicht jedoch bei SQL Server 2008.
SQL Server Reporting Services (Programm)

Hinweis:
Der ReportServer-Anwendungspool wird bei SQL Server 2005 in Internetinformationsdienste (IIS) verwaltet, nicht jedoch bei SQL Server 2008.

Erforderliche Berechtigungen

Zum Verwenden des RenameDT-Befehls müssen Sie Mitglied der Gruppe Team Foundation-Administratoren auf dem Team Foundation-Anwendungsebenenserver und Mitglied der Gruppe sysadmin für SQL Server auf dem Team Foundation-Datenebenenserver sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

Hinweis:
Sie müssen auch dann eine erweiterte Eingabeaufforderung öffnen, wenn Sie mit Administratoranmeldeinformationen angemeldet sind, um diese Funktion auf einem Server auszuführen, auf dem Windows Server 2008 ausgeführt wird. Um eine erweiterte Eingabeaufforderung zu öffnen, klicken Sie auf Start, klicken mit der rechten Maustaste auf Eingabeaufforderung und klicken dann auf Ausführen als Administrator. Weitere Informationen finden Sie auf der Microsoft-Website.

Sie müssen auch dann eine erweiterte Eingabeaufforderung öffnen, wenn Sie mit Administratoranmeldeinformationen angemeldet sind, um diese Funktion auf einem Server auszuführen, auf dem Windows Server 2008 ausgeführt wird. Um eine erweiterte Eingabeaufforderung zu öffnen, klicken Sie auf Start, klicken mit der rechten Maustaste auf Eingabeaufforderung und klicken dann auf Ausführen als Administrator. Weitere Informationen finden Sie auf der Microsoft-Website.

TFSAdminUtil RenameDT servername

Parameter

Argument	Beschreibung
servername	Gibt den Zielcomputernamen auf Datenebene an. Der Computer kann durch Angaben folgender Typen identifiziert werden: IP-Adresse Die IP-Adresse muss das folgende Format aufweisen: aaa.bbb.ccc.ddd. Computername Nur die Zeichen [A-Z \| 0-9 \| -] sind zulässig, Leerzeichen oder Sonderzeichen wie ";:<>* sind nicht erlaubt. Der Computername darf nicht vollständig aus Zahlen bestehen, und er darf bei normalem ASCII-Code nicht länger als 15 Zeichen und bei höherwertiger Zeichencodierung nicht länger als 7 Zeichen sein. Weitere Informationen finden Sie unter Benennungseinschränkungen für Team Foundation Server. Domänenadresse Beispiel: EigenerServer.Standort.Name_des_Unternehmens.de

servername

Gibt den Zielcomputernamen auf Datenebene an. Der Computer kann durch Angaben folgender Typen identifiziert werden:

IP-Adresse

Die IP-Adresse muss das folgende Format aufweisen: aaa.bbb.ccc.ddd.
Computername

Nur die Zeichen [A-Z | 0-9 | -] sind zulässig, Leerzeichen oder Sonderzeichen wie ";:<>* sind nicht erlaubt. Der Computername darf nicht vollständig aus Zahlen bestehen, und er darf bei normalem ASCII-Code nicht länger als 15 Zeichen und bei höherwertiger Zeichencodierung nicht länger als 7 Zeichen sein. Weitere Informationen finden Sie unter Benennungseinschränkungen für Team Foundation Server.
Domänenadresse

Beispiel: EigenerServer.Standort.Name_des_Unternehmens.de

Hinweise

Wichtiger Hinweis:
Es wird empfohlen, die Datenbanken auf dem Team Foundation Server-Datenebenenserver zu sichern.

Die TFSNameUrl- und die TFS-Namenszeichenfolge in der Diensteinstellungsdatei Web.config, die sich unter Laufwerk:\Programme\Microsoft Visual Studio 2008 Team Foundation Server\Web Services auf der Datenebene befindet, müssen auf den aktuellen Team Foundation Server-Datenebenenserver verweisen. Andernfalls schlägt der RenameDT-Befehl ohne Meldung fehl.

Auf der Team Foundation Server-Anwendungsebene muss der genaue Name bzw. die Adresse des Datenebenenservers bekannt sein, sodass mit diesem kommuniziert werden kann. Der Name und die Adresse der Datenebene werden an verschiedenen Stellen in Team Foundation Server gespeichert, sowohl in den Datenbanken der Anwendungsebene als auch in denen der Datenebene. Fall zu einer neuen Datenebene gewechselt werden muss, muss der Administrator sicherstellen, dass Team Foundation Server auf den entsprechenden Namen bzw. die entsprechende Adresse verweist.

Mit dem Befehl RenameDT des Befehlszeilendienstprogramms TFSAdminUtil wird das Umbenennen der Datenebene automatisiert. Team Foundation Server ´wird so aktualisiert, dass auf den neuen Namen bzw. die neue Adresse verwiesen wird. Der Befehl RenameDT kann auch in Skripts verwendet werden, um das Umbenennen der Datenebene zu automatisieren oder zu planen.

Der Befehl RenameDT kann nur auf der Anwendungsebene ausgeführt werden, weil er nach der Datei web.config auf dem Computer sucht, auf dem er ausgeführt wird. Er verfügt über keine Remotefunktionen und akzeptiert keine anderen Parameter, mit denen ein Zielcomputer der Anwendungsebene angegeben werden kann.

Szenarien mit Verwendungsbeispielen

Der Befehl RenameDT kann vom Administrator in verschiedenen Szenarien verwendet werden. Hierzu zählen die in der folgenden Liste aufgeführten Beispielszenarien.

Der Administrator möchte eine Routinewartung der Datenebene ausführen und muss deshalb die Datenebene in den Offlinemodus versetzen. Um eine Downtime zu vermeiden, wird die ursprünglich verwendete Datenebene durch eine temporäre Datenebene ersetzt.
Der Administrator führt den Befehl RenameDT des Befehlszeilendienstprogramms TFSAdminUtil aus, sodass Team Foundation Server nun eine Verbindung mit der neuen temporären Datenebene herstellt. Wenn die Wartung abgeschlossen ist, führt der Administrator das Dienstprogramm erneut aus, um zur vorherigen Datenebene zurückzukehren.
Die Datenebene ist ausgefallen und funktioniert nicht mehr.
Der Administrator führt den Befehl RenameDT aus, damit Team Foundation Server auf einen neuen Sicherungsserver verweist.
Für die Datenebene wird ein Update ausgeführt, und anschließend befindet sie sich auf einem neuen Server.
Der Administrator führt den Befehl RenameDT aus, damit Team Foundation Server auf den neuen Datenebenenserver verweist.
In neuen Betriebsrichtlinien werden genaue Benennungstandards für Computer festgelegt, denen auch die Datenebene entsprechen muss.
Der Administrator benennt die Datenebene mithilfe des Befehls RenameDT in einen besser geeigneten Namen um.
Die Organisation oder das Unternehmen ist gewachsen und muss von einer Lösung mit einem einzigen Server zu einer Lösung mit zwei Servern migrieren.
Nach dem Einrichten der neuen unabhängigen Datenebene führt der Administrator den Befehl RenameDT aus, damit Team Foundation Server auf den neuen Server verweist.