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

• Verwenden von Anführungszeichen und Escapezeichen

• Elementangaben

• Versionsangaben

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,dass ! in ein Versionsgeschichtenereignis erweitert wird.

  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	Description
$/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 (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:

Siehe auch

Weitere Ressourcen

Command-line Reference