Befehlszeilensyntax (Team Explorer Everywhere)

Dieses Thema enthält allgemeine Syntax- und Verwendungsinformationen für das Plattformübergreifender Befehlszeilenclient für Team Foundation Server.

In diesem Thema

Angeben von Optionen

Absolute Pfade auf einem Computer unter Unix beginnen stets mit einem Schrägstrich, daher müssen Sie Optionen mithilfe von Bindestrichen starten. Andernfalls kann das Plattformübergreifender Befehlszeilenclient für Team Foundation Server Pfade und Optionen nicht unterscheiden. In der Dokumentation für den Befehlszeilenclient für Visual Studio werden Beispiele Optionen mithilfe eines Schrägstrichs bezeichnet, für die Befehle, die für beide Clients verwendet werden, müssen Sie jedoch stattdessen den Bindestrich (-) verwenden.

Verwenden von Anführungszeichen und Escapezeichen

Wenn Argumente für Befehle Zeichen enthalten, die von der Shell als Sonderzeichen angesehen werden, müssen Sie die Argumente in Escape- oder Anführungszeichen einschließen. Unter Windows-Betriebssystemen müssen Sie Argumente normalerweise nur in Anführungszeichen ("") einschließen, wenn diese Leerzeichen enthalten. Für Unix-Shells gelten zusätzliche Anforderungen.

Unix-Shells

Unix-Shells unterstützen zahlreiche Sonderzeichen für Platzhalter, reguläre Ausdrücke usw. Literaltext können Sie in Unix-Shells mit folgenden drei Methoden markieren:

  • Stellen Sie einem Zeichen einen umgekehrten Schrägstrich (\) voran, um den Literalwert des Zeichens beizubehalten.

  • 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.

  • Schließen Sie Text in doppelte Anführungszeichen ("") ein, um den Literalwert der eingeschlossenen Zeichen mit der 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.

Tipp

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 zah 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.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie auf einem Computer unter Windows Pfade mit Leerstellen eingeschlossen werden.

tf checkout -recursive “$/Inventory/Client Suite/”

Im folgenden Beispiel wird veranschaulicht, wie auf einem Computer unter Unix der umgekehrte Schrägstrich als Escapezeichen für ein einzelnes Zeichen verwendet wird.

tf checkout -recursive $/Inventory/Client\ Suite/

Im folgenden Beispiel wird veranschaulicht, wie ein Pfad auf einem Computer unter Unix in einfache Anführungszeichen eingeschlossen wird.

tf checkout -recursive ‘$/Inventory/Client Suite/’

Im folgenden Beispiel wird veranschaulicht, wie ein Pfad auf einem Computer unter Unix in doppelte Anführungszeichen eingeschlossen wird.

tf checkin -comment:”Fixed the bug\!” file.java

Im folgenden Beispiel wird veranschaulicht, wie in der Shell csh oder tcsh auf einem Computer unter Unix umgekehrte Schrägstriche als Escapezeichen für Dollarzeichen im Pfad verwendet werden.

tf checkout -recursive \$/Inventory/Client\ Suite/

Im folgenden Beispiel wird veranschaulicht, wie in der Shell csh oder tcsh auf einem Computer unter Unix für Dollarzeichen im Pfad in einfache Anführungszeichen eingeschlossen werden.

tf checkout -recursive ‘$/Inventory/Client Suite/’

Im folgenden Beispiel wird veranschaulicht, wie in der Shell csh oder tcsh auf einem Computer unter Unix für Dollarzeichen im Pfad in doppelte Anführungszeichen eingeschlossen werden.

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

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 die Elementangabe (weitere Informationen finden Sie weiter oben in diesem Thema unter Item Specifications) 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.

LBezeichnungsID

Version von Bezeichnung BezeichnungsID.

Wname; Besitzer

Die Version, die sich derzeit im Besitzer gehörenden Arbeitsbereich Name befindet.

DDatumszeichenfolge

Die Version mit dem Datum und der Uhrzeit wie in Datumszeichenfolge angegeben.

XLöschvorgangsID

Die Version, die gelöscht wurde und der vom Server die LöschvorgangsID zugeordnet wurde.

Siehe auch

Weitere Ressourcen

Befehlszeilenreferenz (Team Explorer Everywhere)

  • Last updated on