Befehl "RenameDT"

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

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. Domänenadresse Beispiel: EigenerServer.Standort.Name_des_Unternehmens.de

Hinweise

Wichtig

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

Der Anwendungsebene für Team Foundation Server muss der genaue Name oder die Adresse des Servers der Datenebene bekannt sein, damit dieser erreicht 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 dafür sorgen, dass Team Foundation Server auf den neuen Namen oder die neue Adresse der Datenebene zeigt.

Mit dem Befehl RenameDT des Befehlszeilendienstprogramms TFSAdminUtil wird das Umbenennen der Datenebene automatisiert. Dadurch wird Team Foundation Server so aktualisiert, dass dort auf den neuen Namen oder die neue Adresse gezeigt 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 zeigt.

• 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 Server der Datenebene zeigt.

• 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 zeigt.

Beispiel

Im folgenden Beispiel werden alle Instanzen des Datenebenennamens in Team Foundation Server in NewName umbenannt.

>TFSAdminUtil RenameDT NewName

Sicherheit

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

Siehe auch

Konzepte

Team Foundation-Anwendungsebenenserver
Team Foundation-Datenebenenserver

Weitere Ressourcen

Befehlszeilenbefehle für "TFSAdminUtil"
Verwenden von Team Foundation Server-Befehlszeilentools
Verwalten von Team Foundation Server
Verwalten von Team Foundation Server-Diensten und -Dienstkonten
Verwalten von Team Foundation Server-Datenebenenservern