Befehlszeilensyntax (Versionskontrolle)
Die Syntax für tf, ein Befehlszeilenhilfsprogramm von Team Foundation, sieht folgendermaßen aus:
tf command item [/options]
In diesem Thema werden die Dokumentationskonventionen sowie Abkürzungen für Befehle, spezielle Befehlszeilenzeichen und die Team Foundation-spezifischen Parameter, Versionsspezifikationen 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, 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 seine Unterverzeichnisse abrufen möchten. Darum müssen Sie den itemspec-Parameter nicht unbedingt eingeben, obwohl er erforderlich ist.
Wenn zwei, Pipe (|)-getrennte Optionen in eckige Klammern eingeschlossen sind, können Sie eine der beiden Optionen, jedoch nicht beide festlegen. Zum Beispiel gibt tf Changeset [/comment:Kommentar|@Kommentardatei] an, dass Sie einen Kommentar für ein Changeset eingeben können, das der /comment:-Option folgt, oder ( |) Sie können einen Pfad zu einer Datei, die einen Kommentar enthält, den Sie verwenden möchten, mithilfe der **@**commentfile-Syntax angeben. 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. Beispiele:
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 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-Befehlszeilenhilfsprogramm 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 den Befehlen oben finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".
Analyse von Element- und Versionsspezifikationen durch Team Foundation
Elementspezifikationspfade
Ein itemspec, kurz für Elementspezifikation, ist ein Satz von einem oder mehreren Zeichen, der Team Foundation versucht, sich als adressierbares Element oder Satz von Elementen aufzulösen, entweder auf dem Computer oder dem Versionskontrollserver.
Sie können für alle Team Foundation-Befehle, die eine Elementspezifikation akzeptieren, entweder lokale Systemdateipfade, 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.
Tipp
Sie können bei Team Foundation-Versionskontrolle-Befehlen 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 ein beliebiges der folgenden Muster, um eine Version anzugeben.
Versionsspezifikation |
Beschreibungen |
|---|---|
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 – Irgendein von .NET Framework unterstütztes Format. – oder – Beliebiges Datumsformat des lokalen Computers. |
Jedes 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 |
Version, die zuletzt mit dem get-Befehl in den Arbeitsbereich heruntergeladen wurde. |
Wworkspacename;workspaceowner |
Version, die zuletzt mit dem get-Befehl in den angegebenen Arbeitsbereich heruntergeladen wurde. Beispiel: WResolveRIConflicts;AKerry |
T |
Aktuellste Version. |
Wenn Sie die Befehle History oder Difference verwenden, können Sie einen Bereich von Versionen angeben, indem Sie die Versionen mit einer Tilde (~) trennen.