Befehlszeilensyntax

Die Syntax für tf, ein Team Foundation-Befehlszeilendienstprogramm, lautet wie folgt:

tf command item [ /options ]

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

Dokumentationskonventionen

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

Syntaxbeispiel: c:\projects>``tf get`` itemspec [/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 eine Differenzmenge 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 shelvesets`` shelvesetname [/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 tf-Befehlszeilendienstprogramm 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 über die oben aufgeführten Befehle finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".

Analyse von Element- und Versionsspezifikationen durch Team Foundation

Elementspezifikationspfade

Eine Elementspezifikation besteht aus ein oder mehr Zeichen, die von Team Foundation auf dem Computer oder dem Quellcodeverwaltungsserver als adressierbare Elemente aufgelöst werden.

Sie können für alle Team Foundation-Befehle, die eine Elementspezifikation akzeptieren, entweder lokale Dateisystempfade, 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.

Wenn die Elementspezifikation einen Serverpfad angibt, muss er vollqualifiziert sein. Beispielsweise können Sie nicht mit der Elementspezifikation ./* alle Elemente unter dem Ordner $/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 der folgenden Muster, um eine Version anzugeben.

Wenn Sie den History-Befehl oder den Difference-Befehl verwenden, können Sie einen Bereich von Versionen angeben, indem Sie die Versionen mit einer Tilde (~) trennen.

Siehe auch

Referenz

Befehlszeilenoptionen

Konzepte

Informationsbefehle
Arbeiten mit Quellcodeverwaltungsshelvesets
Arbeiten mit Differenzmengen der Quellcodeverwaltung

Weitere Ressourcen

Team Foundation-Quellcodeverwaltung: Befehlszeilenreferenz
Befehle des Befehlszeilendienstprogramms "Tf"