Befehlszeilensyntax (Team Explorer Everywhere)
Sie haben nun Plattformübergreifender Befehlszeilenclient für Team Foundation Server installiert. Bevor Sie einen Befehl eingeben, müssen Sie sich jedoch mit den allgemeinen Informationen zur Syntax und zur Verwendung vertraut machen.
In diesem Thema
Angeben von Optionen
Auf UNIX-Computern beginnen absolute Pfade mit einem Schrägstrich (/). Verwenden Sie also einen Bindestrich (-), um Optionen zu starten. Andernfalls kann Plattformübergreifender Befehlszeilenclient für Team Foundation Server einen Pfad nicht von einer Option unterscheiden.
Verwenden von Anführungszeichen und Escapezeichen
Unix-Shells unterstützen zahlreiche Sonderzeichen für Platzhalter, reguläre Ausdrücke usw. Wenn diese Argumente Zeichen enthalten, die von der Shell als Sonderzeichen angesehen werden, müssen Sie die Argumente in Escape- oder Anführungszeichen einschließen. Sie können Literaltext in Unix-Shells wie hier gezeigt markieren:
Stellen Sie einem Zeichen einen umgekehrten Schrägstrich (\) voran, um den Literalwert des Zeichens beizubehalten. Beispiel:
tf checkout -recursive $/Inventory/Client\ Suite/Schließen Sie Text in einfache Anführungszeichen ('') ein, um die Literalwerte der eingeschlossenen Zeichen beizubehalten. Mit einem Dollarzeichen ($) gekennzeichnete Shellvariablen sowie Platzhalter werden nicht erweitert, wenn sie in einfache Anführungszeichen eingeschlossen werden. Beispiel:
tf checkout -recursive ‘$/Inventory/Client Suite/’Schließen Sie Text in doppelte Anführungszeichen ("") ein, um den Literalwert der eingeschlossenen Zeichen mit Ausnahme von $, ', \ und ! beizubehalten.
Aufgrund dieser Ausnahmen werden weiterhin Variablen erweitert, Subshells ausgewertet, wird der umgekehrte Schrägstrich als Escapezeichen verwendet und werden Verlaufsereignisse erweitert. Das folgende Beispiel zeigt, dass weiterhin ein umgekehrter Schrägstrich benötigt wird, um zu verhindern! in ein Versionsgeschichtenereignis erweitert werden.
tf checkin -comment:”Fixed the bug\!” file.java
Serverpfade für Visual Studio Team Foundation Server beginnen mit einem Dollarzeichen, doch in Unix-Shells wird mit Dollarzeichen die Variablenerweiterung begonnen. Shells wie sh, ksh, bash und zsh erkennen, dass ein Zeichen, das in einem Serverpfad auf ein Dollarzeichen folgt, kein gültiger Variablenname ist. Daher übergeben diese Shells das Dollarzeichen unverändert an das Plattformübergreifender Befehlszeilenclient für Team Foundation Server.
In von csh (sowie tcsh) abgeleiteten Shells wird die Befehlszeile jedoch nicht auf diese Weise analysiert. In diesen Shells wird das Dollarzeichen gelesen und versucht, eine Variable zu einzusetzen, die zum folgenden Text passt. Da der nachfolgende Text aus einem Schrägstrich (/) besteht und diese Shells Variablennamen erfordern, die mit einem Buchstaben beginnen, tritt ein Fehler auf. Wenn Sie die Shells csh oder tcsh verwenden, müssen Sie als Escapezeichen für die Dollarzeichen in Serverpfaden jeweils einen umgekehrten Schrägstrich oder einfache Anführungszeichen verwenden. Bei doppelten Anführungszeichen versucht die Shell, die Variable zu erweitern. Hier sehen Sie einige Beispiele für Anführungszeichen und Escapezeichen für csh-Shells:
tf checkout -recursive \$/Inventory/Client\ Suite/
tf checkout -recursive ‘$/Inventory/Client Suite/’
tf checkout -recursive \$”/Inventory/Client Suite/”
Elementangaben
Als Elementangabe wird ein lokaler oder Serverpfad bezeichnet, der eine Datei oder einen Ordner beschreibt, die bzw. der als Eingabeparameter für eine Option oder einen Befehl für das Plattformübergreifender Befehlszeilenclient für Team Foundation Server verwendet wird. Elementangaben können ein durch ein Semikolon getrenntes Versionsangabesuffix enthalten. Dieses Suffix ist optional. Geben Sie das Suffix nur an, wenn Sie auf eine frühere Version eines Elements verweisen möchten.
Beispiele für Elementangaben:
Elementangabe |
Beschreibung |
|---|---|
$/Inventory/src |
Serverpfad zu einem Ordner |
$/Inventory/src/Class.java |
Serverpfad zu einer Datei |
/tmp/Inventory |
Lokaler Pfad (Unix) zu einem Arbeitsordner |
/tmp/Inventory/src/Class.java |
Lokaler Pfad (Unix) zu einer Datei |
C:\Inventory\src |
Lokaler Pfad (Windows) zu einem Arbeitsordner |
C:\Inventory\src\Class.java |
Lokaler Pfad (Windows) zu einer Datei |
$/Inventory/src;C4095 |
Serverpfad zu einem Ordner bei Changeset 4095 |
.\Class.java;C129 |
Relativer lokaler Pfad (Windows) zu einer Datei bei Changeset 129 |
./Class.java;Lrelease-1.0 |
Relativer lokaler Pfad (Unix) zu einer Datei mit Bezeichnungsversion 1.0 |
$/Inventory/src/file.txt;Wdev;john |
Serverpfad in der Version im Entwicklerarbeitsbereich, der John gehört. |
file.txt;D01/01/2007 |
Lokaler Pfad am 1. Januar 2007 Hinweis Datumsangaben gemäß ISO 8601 werden unterstützt.Datumsangaben werden entsprechend dem Gebietsschema des Benutzers analysiert. |
file.txt;X1067 |
Zuvor gelöschte Datei mit deletionID 1067 |
Versionsangaben
Als Versionsangabe wird eine besonders formatierte Zeichenfolge bezeichnet, die auf eine bestimmte Einzelversion oder einen Bereich von Versionen eines Elements in der Versionskontrolle verweist. Versionsangaben werden für zwei Zwecke verwendet: als Suffixe für Elementangaben (siehe Elementangaben in diesem Thema) sowie als eigenständige Werte für die -version - Option für bestimmte Befehle.
Beispiele für Versionsangaben:
Format der Versionsangabe |
Beschreibung |
|---|---|
T |
Aktuelle Version. |
Cn |
Version bei Changeset n. |
LlabelID |
Version von Bezeichnung labelID. |
W name; owner |
Die Version derzeit im name gehörenden Arbeitsbereich durch owner. |
D datestring |
Die Version mit dem Datum und der Uhrzeit wie in datestring angegeben |
XdeletionID |
Die Version, die gelöscht wurde und der vom Server die deletionID zugeordnet wurde. |