Skripts und Befehlsdateien der Team Foundation-Versionskontrolle
Aktualisiert: November 2007
Sie können auf der Befehlszeile mehrere Befehle der Team Foundation-Versionskontrolle assemblieren und ausführen, indem Sie einen Befehl in eine Befehlsdatei umleiten oder in eine Batchdatei oder ein Skript einfügen.
Befehlsdateien: Erstellen von Befehlsgruppen
Mit einer Befehldatei können Sie mehrere Befehle schneller als eine Reihe einzelner Befehle ausführen, weil eine Befehlsdatei eine einzelne Verbindung mit dem Server der Anwendungsebene wiederverwendet und nur eine einzige Instanz von tf erstellt.
Der Befehlsdateischalter ist das @-Zeichen. Um mit tf eine Befehlsdatei aufzurufen, verwenden Sie die folgende Syntax:
tf @commandfilename.tfc argument1 argument2 …
Im folgenden Beispiel wird Team Foundation angewiesen, in der Datei buildcommands.tfc nach zusätzlichen Anweisungen zu suchen. Bei Verwendung der folgenden Eingabe in diesem Beispiel wird die letzte Version von 314.cs vom Server der Team Foundation-Versionskontrolle abgerufen, sie wird in den Arbeitsbereich ausgecheckt, nach c:\newbranch\ verzweigt, und die Änderungen werden an den Server der Team Foundation-Versionskontrolle übergeben.
c:\projects>tf @buildcommands.tfc 314.cs c:\newbranch\
Inhalt von buildcommands.tfc:
get %1
checkout %1
branch %1 %2
checkin
Wenn der Befehlsdateischalter angegeben wird, können Sie eine beliebige Anzahl von Argumenten einfügen. Mit Argumenten werden Werte für die Befehle in der Befehlsdatei bereitgestellt. Standardargumente umfassen Dateinamen, Pfade, Benutzernamen, Kommentare und Versionsspezifikationen.
Unterdrücken und Wiederherstellen der Interaktivität der Eingabeaufforderung
Befehlsdateien sind standardmäßig nicht interaktiv. Für viele Befehle, z. B. undo, wird der interaktive Modus als Standardmodus verwendet, wenn sie mit der Befehlszeilenanwendung tf ausgeführt werden. Bei der Ausführung einzelner Team Foundation-Befehle können Sie das /noprompt-Flag einfügen, um Warnmeldungen zu umgehen und diese Befehle nicht interaktiv ausführen. In Befehlsdateien ist /noprompt implizit enthalten.
Beispielbefehlsdatei
Wenn Sie den folgenden Befehl ausführen, analysiert Team Foundation BuildProject.tfc und erstellt den Arbeitsbereich HumongousInsurance 2.3, ruft die letzte Version des Projekts HumongousInsurance ab, verzweigt die neue Version in Humongous Insurance V2.3, und versieht die neue Version mit einer Bezeichnung. Für jeden neuen Build wird einfach die Befehlsdatei mit dem Projektnamen, der Versionsnummer und dem lokalen Verzeichnis des neuen Builds ausgeführt.
c:\>tf @BuildProject.tfc HumongousInsurance 2.3 c:\projects
Inhalt von BuildProject.tfc:
cd %3
rem Change the current directory from whatever it is to the project folder.
workspace /new /s:TeamServer2 /user:UNO\juan %1BuildWS%2
rem Create a new workspace on the TeamServer2 server as user UNO\juan.
rem Assign a name to the workspace that concatenates the first command line argument (%1) + "BuildWS" + the second command line argument (%2)
get %1 /recursive
rem retrieve the latest version of the first command line argument.
branch %1 %1V%2
checkin /comment:”This is build v%2 of %1”
label %1Build%2 /category:builds /comment:”%1 Build %2” %1V%2
workspace /delete %1BuildWorkspace%2
Siehe auch
Konzepte
Referenz
Befehlszeilensyntax (Team System)