Befehlszeilensyntax (Team System)

Aktualisiert: November 2007

Die Syntax für das Befehlszeilenprogramm tf.exe.

tf command item [/options]

In diesem Thema werden die Dokumentationskonventionen, Abkürzungen für Befehle, spezielle Befehlszeilenzeichen und die Team Foundation-spezifischen Parameter versionspec und itemspec beschrieben.

Dokumentationskonventionen

[/Brackets] stellen Optionen dar, die zum Ausführen eines Befehls nicht erforderlich sind. Elemente, die nicht in eckigen Klammern eingeschlossen sind, stellen Parameter dar, die zum Ausführen des Vorgangs erforderlich sind. Beispielsweise ist im folgenden Befehl Elementspezifikation erforderlich, und /recursive ist optional:

Syntaxbeispiel: c:\projects>tf getitemspec [/recursive]

Tatsächlicher Befehl: c:\projects>tf get c:\projects /recursive

Alternativer Befehl: c:\projects>tf get /recursive

Im Beispiel für den alternativen Befehl folgert Team Foundation, dass Sie den Inhalt des aktuellen Verzeichnisses c:\projects und alle Unterverzeichnisse abrufen möchten. Darum müssen Sie den itemspec-Parameter nicht unbedingt eingeben, obwohl er erforderlich ist.

Wenn zwei durch einen senkrechten Strich (|) getrennte Optionen in eckige Klammern eingeschlossen sind, können Sie eine der beiden Optionen, jedoch nicht beide festlegen. Beispielsweise bedeutet tf Changeset [/comment:Kommentar|@Kommentardatei] , dass Sie nach der /comment:-Option einen Kommentar für ein Changeset eingeben oder (|) mit der **@**Kommentardatei-Syntax den Pfad einer Datei angeben können, die einen zu verwendenden Kommentar enthält. Sie können jedoch nicht sowohl einen Kommentar als auch eine Kommentardatei angeben.

In Syntaxbeispielen sind kursive Elemente Parameter, die Sie durch die tatsächlichen Zeichen zum Ausführen eines Befehls ersetzen müssen. Fett formatierte Elemente sind Optionen, die Sie wörtlich einfügen. Beispiel:

Syntaxbeispiel: tf shelvesetsshelvesetname [/recursive]

Tatsächlicher Befehl: c:\projects>tf shelvesets BuddyTest_23

Sonderzeichen für die Befehlszeile

Sie können das auch als Befehlsdateischalter bezeichnete Zeichen "@" verwenden, um eine Reihe von Team Foundation-Befehlen gleichzeitig auszuführen. Der größte Vorteil der Verwendung des Befehlsdateischalters an der Eingabeaufforderung, in einer Befehlsdatei oder in einer Batch- oder Skriptdatei ist die höhere Geschwindigkeit im Vergleich zur Ausführung einzelner Befehle. Weitere Informationen finden Sie unter Befehlszeilenoptionen.

Befehlsverknüpfungen und -aliase

Die folgenden definierten Befehlsverknüpfungen und -aliase werden für das Befehlszeilendienstprogramm tf unterstützt:

• del = delete (löschen)

• diff = difference (Unterschied)

• edit = checkout (Auschecken)

• hist = history (Versionsgeschichte)

• perm = permission (Berechtigung)

• prop = properties (Eigenschaften)

• ren = rename (umbenennen)

• rename = move (verschieben)

• stat = status (Status)

• undel = undelete (wiederherstellen)

Weitere Informationen zu diesen Befehlen finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".

Analyse von Element- und Versionsspezifikationen durch Team Foundation

Elementspezifikationspfade

Eine Elementspezifikation (itemspec) besteht aus einem oder mehreren Zeichen. Diese Zeichen werden von Team Foundation als Elemente aufgelöst werden, die auf Dateisystem- oder UNC-Pfade verweisen, die entweder einem Arbeitsbereich oder dem Versionskontrollserver zugeordnet sind.

Sie können für alle Team Foundation-Befehle, die eine Elementspezifikation akzeptieren, entweder lokale Dateipfade, z. B. c:\projects, oder UNC-Pfade, z. B. \\myshare\projects, oder Serverpfade, z. B. $/projects/myfiles, angeben.

Für lokale Pfade können Sie relative Pfade angeben. Wenn z. B. das aktuelle Verzeichnis c:\projects lautet und Sie alle Elemente in einem Unterverzeichnis des Ordners projects auschecken möchten, können Sie tf checkout .\* /recursive eingeben.

Hinweis:
Sie können in Befehlen der Team Foundation-Versionskontrolle Platzhalterzeichen verwenden, z. B. *, ? und #.

Wenn die Elementspezifikation einen Serverpfad angibt, muss er vollqualifiziert sein. Beispielsweise können Sie mit der Elementspezifikation ./* nicht alle Elemente unterhalb des Ordners $/projects auschecken.

Versionsspezifikationen

Eine Versionsspezifikation gibt die Version eines Elements an, mit dem Sie arbeiten möchten. Sie können in einem Befehl Versionen angeben, indem Sie entweder die Versionsspezifikation in die version-Option einschließen (z. B. /version:C1256), oder indem Sie die Versionsspezifikation mit einem Semikolon an einen Dateinamen anfügen (z. B. filename;Lmylabel).

Verwenden Sie eines oder mehrere der folgenden Muster, um eine Version anzugeben.

Wenn Sie die Befehle History, Difference oder Merge verwenden, können Sie einen Bereich von Versionen angeben, indem Sie die Versionen mit einer Tilde (~) trennen. Die folgenden Beispiele erläutern, wie Sie einen Bereich angeben, indem Sie Versionen mit einer Tilde trennen:

So zeigen Sie den Verlauf der Datei Form1.cs nur für Changeset 137 an

Syntaxbeispiel: **tf history /version:**C137~C137

So rufen Sie den Unterschied zwischen Changesets C123 und C125 für die Datei form.cs ab

Syntaxbeispiel: tf difference/versionC123~C125 form1.cs.

So führen Sie alle Versionen vom ersten Changeset bis zu Changeset C125 in branch2 zusammen

Syntaxbeispiel: **tf merge/version:**C125 branch1 branch2.

Siehe auch

Konzepte

Informationsbefehle

Arbeiten mit Versionskontrollshelvesets

Arbeiten mit Changesets der Versionskontrolle

Referenz

Befehlszeilenoptionen

Weitere Ressourcen

Befehlszeilenreferenz der Team Foundation-Versionskontrolle

Befehle des Befehlszeilendienstprogramms "Tf"