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.
.gif "Hinweis") 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.
Versionsspezifikation |
Beschreibung |
|---|---|
Changeset |
Version, die zur Changesetnummer changeset gehört. Beispiel: C1256. |
LBezeichnung |
Version, die zur Bezeichnung label gehört. Beispiel: Lmylabel. |
Djjjj-mm-ttTxx:xx - oder - Dmm/tt/jjjj - oder - Beliebiges von .NET Framework unterstütztes Format - oder - Beliebiges Datumsformat des lokalen Computers. |
Beliebiges Datums- und Uhrzeitformat, das von einer .NET Framework-Methode analysiert werden kann. Beispiel: D2008-01-21T16:00. Weitere Informationen zu unterstützten Datums- und Uhrzeitformaten finden Sie unter DateTime-Struktur in der .NET Framework-Klassenbibliothek. |
W |
Die zuletzt mit dem Befehl get in den Arbeitsbereich abgerufene Version. |
T |
Letzte Revision |
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
Arbeiten mit Versionskontrollshelvesets
Arbeiten mit Changesets der Versionskontrolle