Share via


Befehlszeilenreferenz der Team Foundation-Versionskontrolle

Sie können Versionskontrollenbefehle, fast alle Aufgaben ausführen, die Sie in Visual Studio ausführen können und auch mehrere Aufgaben verwenden, die nicht in Visual Studio ausgeführt werden können.Sie können das tf.exe Tool verwenden, um Versionskontrollenbefehle der Eingabeaufforderung oder in einem Skript ausführen.

Was möchten Sie tun?

  • Führen Sie einen Befehl aus

    • Installieren Sie den Entwickler-Computer

    • Entwickeln Sie die App

    • Halten Sie die Arbeit an

    • Registrieren Sie Ihre Arbeit bei

    • Verwalten von Dateien und lösen Sie Probleme

    • Suchen Sie Risiko

  • Verstehen Befehlssyntax

  • Geben Sie die Elemente, die von einem Befehl betroffen sind

    • Verwenden Sie ein itemspec Argument, um betroffene Elemente anzugeben

    • Verwenden Sie eine Versionsspezifikation Argument, um betroffene Versionen von Elementen anzugeben

  • Verwenden Sie Optionen zu ändern, wie Befehlsfunktionen

    • Verwenden Sie die Option /noprompt-, Optionen für die Dateneingabe zu unterdrücken und Ausgabedaten zum Eingabeaufforderungsfenster umzuleiten

    • Verwenden Sie /login- Option, Anmeldeinformationen anzugeben, wenn Sie einen Befehl ausführen

    • Verwenden Sie die Option /lock-, eine Sperre anzuwenden oder zu entfernen

    • Verwenden Sie Optionsverknüpfungen

  • Verstehen Exitcodes

Führen Sie einen Befehl aus

Um zum Starten der Visual Studio-Eingabeaufforderung, Windows Start, wählen Sie Microsoft Visual Studio 2012, Visual Studio Tools, und wählen Sie dann eine der Eingabeaufforderung Tastenkombinationen aus.

In den meisten Fällen führen Sie den Versionskontrollenbefehl im Kontext eines Verzeichnisses aus, das im Arbeitsbereich zugeordnet ist.Beispielsweise wird $/SiteApp/Main/ zu c:\code\SiteApp\Main\ zugeordnet.Um die letzte Version aller Elemente im Arbeitsbereich abrufen:

c:\code\SiteApp\Main\SolutionA>tf get
HinweisHinweis

Es nicht nur veröffentlichen die einige der Themen erneut.Sie können jedoch die Visual Studio 2010-Version dieser Themen lesen.

cc31bk2e.collapse_all(de-de,VS.110).gifInstallieren Sie den Entwickler-Computer und verwalten Sie Arbeitsbereiche

der Arbeitsbereich ist eine lokale Kopie von CodeBase des Teams.Da es sich um eine lokale Kopie auf dem Entwickler-Computer ist, können Sie den Code isoliert entwickeln und testen, bis Sie bereit sind, die Arbeit in zu überprüfen.Im Folgenden werden einige Befehle, den Arbeitsbereich zu verwalten:

Siehe auch: Einrichten des Entwicklercomputers und Verwenden der Versionskontrolle, Verwalten der Arbeitsbereiche

cc31bk2e.collapse_all(de-de,VS.110).gifEntwickeln Sie die App

Verwenden Sie diese Befehle, die App unter Versionskontrolle mit dem Team verwendet werden:

Siehe auch: Entwickeln von Apps in einer Codebasis unter Versionskontrolle

cc31bk2e.collapse_all(de-de,VS.110).gifHalten Sie die Arbeit an

Aus mehreren Gründen Sie manchmal Anforderung, einige oder alle Shelveset zurückstellen das gerade Aufgaben bearbeiten.Um die Arbeit angehalten und fortgesetzt, und die Shelvesets zu verwalten, verwenden Sie diese Befehle:

Siehe auch: Unterbrechen der Arbeit und Verwalten von Shelvesets.

cc31bk2e.collapse_all(de-de,VS.110).gifRegistrieren Sie Ihre Arbeit bei

Hier ist, wie im Code zu CodeBase des Teams überprüft:

  • Befehl Checkin
    Überprüft ausstehende Änderungen in den Dateien oder Ordner an den Server.

Siehe auch: Einchecken von Arbeit an der Teamcodebasis

cc31bk2e.collapse_all(de-de,VS.110).gifVerwalten von Dateien und lösen Sie Probleme

cc31bk2e.collapse_all(de-de,VS.110).gifSuchen Sie Risiko

Verwenden Sie die folgenden Befehle, Risiko mithilfe der Verzweigungen zu suchen:

Siehe auch: Isolieren von Risiken mithilfe von Verzweigungen.

cc31bk2e.collapse_all(de-de,VS.110).gifVerwalten von Versionskontrolle

Verwenden Sie die folgenden Befehle, Ihr Versionskontrollsystem zu verwalten:

Siehe auch: Verwalten der Team Foundation-Versionskontrolle (Visual Studio 2010).

cc31bk2e.collapse_all(de-de,VS.110).gifRufen Sie Hilfe zu Versionskontrollen-Befehlen ab

Verwenden Sie die folgenden Befehle, weitere Informationen über Versionskontrollenbefehle abzurufen:

Verstehen Befehlssyntax

Die Syntax jedes Befehls wird am oberen Rand jedes Referenzthemas.

cc31bk2e.collapse_all(de-de,VS.110).gifErforderliche und optionale Argumente

Argumente Nicht-in Klammern sind erforderlich.[Brackets] geben optionale Argumente an, die nicht erforderlich sind, um einen Befehl abzuschließen.haben jedoch einige optionale Argumente Standardwerte, die dem Befehl angewendet werden, auch wenn Sie nicht die - Option angeben.

cc31bk2e.collapse_all(de-de,VS.110).gifExklusive Argumente

Wenn Optionen durch eine Pipe getrennt werden (|), können Sie eine der Optionen angeben.

cc31bk2e.collapse_all(de-de,VS.110).gifWörtliche und austauschbare Argumente

Fett formatierte Elemente sind Optionen, die Sie wörtlich einfügen.Kursiv gedruckt-Elemente sind Argumente, die Sie durch tatsächliche Zeichen ersetzen müssen, um einen Befehl auszuführen.

cc31bk2e.collapse_all(de-de,VS.110).gifBefehlsverknüpfungen und -aliase

Einige Befehle unterstützen Tastenkombinationen.Beispielsweise können Sie Löschbefehl entweder mit tf delete oder tf del aufrufen.

cc31bk2e.collapse_all(de-de,VS.110).gifBeispiel

Beispielsweise Auscheckenbefehl:

tf checkout [/lock:( none|checkin|checkout)] [/recursive] itemspec [/login: username,[ password]]

Sehen Sie sich die Argumente von diesem Beispiel überprüfen:

  • itemspec: Sie müssen dieses Argument als itemspec ersetzen, das die Elemente angibt, die, Sie auschecken.

  • /lock:(none|checkin|checkout): Es ist nicht erforderlich, die /lock Option anzugeben.Wenn Sie sie nicht angeben, gibt das System standardmäßig /lock:none an.Andernfalls können Sie eine der Sperrenoptionen angeben.

  • Die folgenden Argumente sind optional und wenn Sie sie nicht bereitstellen, gelten keine ihrer Auswirkungen auf den Befehl zu:

    • /recursive: Wenn Sie mehrere Elemente in einem Ordner rekursiv auschecken möchten, müssen Sie diese Option in keinem Fall in vollem Wortlaut angeben.

    • /login:BenutzernameKennwort,: Wenn Sie den Befehl als ein anderer Benutzer ausführen möchten, müssen Sie die Option /login keinem Fall in vollem Wortlaut angeben, ersetzen Benutzername durch den Namen des Benutzers, und bei Bedarf, können Sie das Kennwort angeben.

Geben Sie die Elemente, die von einem Befehl betroffen sind

Sie können itemspecs und versionspecs verwenden, um anzugeben, welche Elemente durch einen Befehl betroffen sind.

cc31bk2e.collapse_all(de-de,VS.110).gifVerwenden Sie ein itemspec Argument, um betroffene Elemente anzugeben

Sie verwenden itemspec-Elementspezifikation () die Elemente anzugeben, die von einem Befehl betroffen sind.Sie können Elemente entweder auf einem Clientcomputer oder im Team Foundation Server angeben.Sie können Platzhalterzeichen wie * und ? verwenden.

cc31bk2e.collapse_all(de-de,VS.110).gifClient itemspec Argumente

Ein Client itemspec Argument gibt einen Pfad zu den Elementen auf einem Clientcomputer wie einem Ordner (beispielsweise, c:\code\SiteApp\Main\SolutionA\) eine Datei an (beispielsweise, c:\code\SiteApp\Main\SolutionA\Project1\program.cs oder mehrere Dateien (beispielsweise, c:\code\SiteApp\Main\SolutionA\*.cs.Sie können UNC-Pfade wie \\myshare\code\SiteApp\Main auch angeben.

cc31bk2e.collapse_all(de-de,VS.110).gifServer itemspec Argumente

Ein Server itemspec Argument gibt einen Pfad zu den Elementen im Team Foundation Server wie einem Ordner (beispielsweise, $/SiteApp/Main/SolutionA) eine Datei an (beispielsweise, $/SiteApp/Main/SolutionA/Project1/program.cs oder mehrere Dateien (beispielsweise, $/SiteApp/Main/SolutionA/*.cs.

Sie verwenden in der Regel Server itemspec Argumente, wenn Sie die Ausführung ein Befehl für Elemente nicht auf dem Clientcomputer erfordern.Beispielsweise besitzen Sie auf einem Entwicklercomputer und fordern, einige Revisionsverlaufdaten über mehrere Elemente abzurufen, die in einer Teamprojektsammlung sind, die Sie nicht in bearbeiten:

c:\>tf history /collection:http://fabrikam-3:8080/tfs/DefaultCollection
$/SiteApp/Main/SolutionA/Project1/* /recursive  
/noprompt 

cc31bk2e.collapse_all(de-de,VS.110).gifMehrere itemspec Argumente

Für einige Befehle können Sie mehrere itemspec-Argumente angeben.Beispiel:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Überprüfungen out program.cs und program2.c.

cc31bk2e.collapse_all(de-de,VS.110).gifVerwenden Sie eine Versionsspezifikation Argument, um betroffene Versionen von Elementen anzugeben

Sie verwenden versionspec (Versionsspezifikation) um die Version von Elementen anzugeben, die von einem Befehl betroffen sind.So versionspec bereitstellen können Sie:

  • Verwenden Sie die /version-Option.Beispiel: /version:C44.

  • Fügen Sie die Versionsspezifikation zu einem itemspec mit einem Semikolon.Beispiel: program1.cs;C44.

Wenn Sie Befehl History oder Difference Command verwenden, können Sie einen Bereich von Versionen angeben, indem Sie die Versionen mit einer trennen Tilde (~).Beispiel:

c:\code\SiteApp\Main\SolutionA>tf history /noprompt * /recursive /v:D4/12/2012~D4/24/2012

Verwenden Sie die folgende Syntax, um versionspec anzugeben.

Typ

Syntax

Beschreibung

Changeset

[C]n

Gibt Elemente auf Grundlage einer Changesetnummer an.Wenn ein Element, das im Bereich ist, nicht im angegebenen Changeset geändert wurde, setzt das System die neueste Version des Elements, das vor dem angegebenen Changeset aufgetreten ist.

TippTipp
Sie können C auslassen, wenn Sie nur eine Zahl angeben.

Beispiele

c:\code\SiteApp\Main>tf get readme.txt /v:C8

– oder –

c:\code\SiteApp\Main>tf get readme.txt /v:8

– oder –

c:\code\SiteApp\Main>tf get readme.txt;8

Wenn Infodatei in Changeset 8 geändert wurde, ruft diese Version der Datei ab.Andernfalls wird die letzte Version der Infodatei vor Version 8. ab.

Bezeichnung

Llabel

Gibt Elemente an, auf die label angewendet wurde.

Beispiele

c:\code\SiteApp\Main>tf get readme.txt;LJulyHotFix

Ruft die Version der Infodatei ab, die JulyHotFix gekennzeichnet wurde.

c:\code\SiteApp\Main>tf get /version:LLastKnownGood

Ruft die Version aller Elemente mit Bezeichnung (und der Löschvorgänge diese Elemente keine Bezeichnung) im Arbeitsbereich ab, wie diese vorhanden waren, als das Changeset, das als LastKnownGood Bezeichnung wurde beispielsweise möglicherweise als Teil automatisierter Buildprozess erstellt wurde.

Datum und Uhrzeit

Dyyyy-mm-ddTxx:xx

- oder -

Dmm/dd/yyyy

- oder -

Irgendein von .NET Framework unterstütztes Format.

- oder -

Eine der Datumsformate unterstützt auf den lokalen Computer.

Gibt ein Changeset an, das an einem bestimmten Datum und einer Uhrzeit erstellt wird.

Beispiele

c:\code\SiteApp\Main>tf get /version:D2004-03-22

Aktualisiert den Arbeitsbereich, um CodeBase zu vergleichen, während sie von 3/22/2004 00:00 Uhr (Mitternacht) vorhanden war.

c:\code\SiteApp\Main>tf get /version:D2004-03-22T09:00

Aktualisiert den Arbeitsbereich, um CodeBase zu vergleichen, während sie von 3/22/2004 09:00 war (9 Uhr).

Weitere Informationen zu .NET Framework-unterstützte Datums- und Uhrzeitformate finden Sie unter DateTime und Datums- und Uhrzeitstandardformatzeichenfolgen.

Arbeitsbereich (aktuelle)

W

Gibt die Version im Arbeitsbereich an.

Arbeitsbereich (angegeben)

Wworkspacename; workspaceowner

Gibt die Version in einem angegebenen Arbeitsbereich an.

Beispiel: WResolveRIConflicts;PeterW

Tipp

T

Gibt die neueste Version an.

Verwenden Sie Optionen zu ändern, wie Befehlsfunktionen

Sie können einige allgemeine Optionen verwenden, wie Befehlsfunktionen zu ändern.

cc31bk2e.collapse_all(de-de,VS.110).gifVerwenden Sie die Option /noprompt-, Optionen für die Dateneingabe zu unterdrücken und Ausgabedaten zum Eingabeaufforderungsfenster umzuleiten

Verwenden Sie die Option /noprompt, Optionen für die Dateneingabe zu unterdrücken und Ausgabedaten zum Eingabeaufforderungsfenster umzuleiten.Diese Option kann hilfreich sein, wenn Sie Versionskontrollenbefehle in einem Skript verwenden müssen, weil der Befehl ohne Intervention durch einen Benutzer weiterhin und die Daten verfügbar sind, damit das Skript Vorgänge wie Analyse oder Ablaufverfolgung ausführt.

Wenn Sie diese Option verwenden, das System:

  • Unterdrückt alle Optionen für Eingabe:

    • Fragen werden nicht im Eingabeaufforderungsfenster bereitgestellt.Wenn Sie beispielsweise Befehl Undo mit dieser Option verwenden, erfordert das System Sie nicht auf, um zu bestätigen, wenn Sie mit dem Annullieren der Änderungen fortfahren möchten.

    • Fenster und Dialogfelder werden nicht angezeigt.Zum Beispiel verwenden Sie diese Option mit Befehl Checkin.Anstatt das Dialogfeld anzuzeigen, Einchecken fort, damit Sie die Optionen bestätigen (die Elemente oder die Sie einchecken möchten, Zuordnen die Arbeitsaufgaben), wird das System mit der Überprüfung in ohne Bestätigung.

  • Leitet Ausgabedaten zur Eingabeaufforderung um.Zum Beispiel verwenden Sie diese Option mit Befehl History.Die Daten werden im Eingabeaufforderungsfenster anstelle Fenster Versionsgeschichte angezeigt.

cc31bk2e.collapse_all(de-de,VS.110).gifVerwenden Sie /login- Option, Anmeldeinformationen anzugeben, wenn Sie einen Befehl ausführen

Verwenden Sie die Option /login, das Team Foundation Server-Benutzerkonto anzugeben, um einen Befehl auszuführen.Diese Option kann hilfreich sein, wenn Sie am Computer eines anderen Teammitglieds arbeiten.

funktioniert beispielsweise Julia mit Peter an seinem Entwickler-Computer.Sie Sperrbefehl verwendet, um eine diese Datei auf sie sperrte zuvor:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI,JuliaPassword

Wenn sie möchte vermeiden, ihr Kennwort zu haben, werden Sie in der Eingabeaufforderung, kann sie den Befehl ohne das Kennwort eingeben:

c:\code\SiteApp\Main> tf lock /lock:none program.cs /login:JuliaI

Nachdem sie diesen Befehl eingeben, benötigt das System sie dann auf, ihr Kennwort in einem Dialogfeld einzugeben, das die Eingabe maskiert.

cc31bk2e.collapse_all(de-de,VS.110).gifVerwenden Sie die Option /lock-, eine Sperre anzuwenden oder zu entfernen

Wichtiger HinweisWichtig

Als empfohlene Vorgehensweise verwenden Sie die Option /lock Vorsicht walten und wenden Sie Ihre Teamkollegen, warum Sie ein Element sperren und wenn Sie planen, die Sperre zu entfernen.

Verwenden Sie die Option /lock anzuwenden, oder, eine Sperre zu entfernen gleichzeitig führen Sie einen anderen Befehl wie Fügen Sie hinzu oder Bearbeiten aus.

/lock:(none|checkin|checkout)
  • None: Für das Element wird keine Sperre festgelegt.Wenn bereits eine Sperre vorhanden ist, wird sie aufgehoben.

  • Checkin oder Checkout: Wendet eine Sperre an.Siehe Verstehen von Sperrtypen.

HinweisHinweis

In einigen Fällen kann schlägt der Sperrvorgang fehl:

  • Wenn eine haben andere Benutzer eines der angegebenen Elemente, schlägt der Sperrvorgang fehlgeschlagenen gesperrt.

  • Das System ignoriert diesen Schalter, wenn bereits eine ausstehende Änderung auf das Element gibt.In diesem Fall müssen Sie Lock Command verwenden, um ein Element zu ändern.

cc31bk2e.collapse_all(de-de,VS.110).gifVerwenden Sie Optionsverknüpfungen

Sie können die folgenden Optionen abkürzen.

Option

Optionsalias

/comment

-C

/computer

-M

/delete

-D

/force

-P

/format

-F

/help

-?, -H

/lock

-K

/login

-Y

/newname

-N

/noprompt

-I

/owner

-O

/recursive

-R

/server

-S

/slotmode

-X

/template

-T

/user

-U

/version

-V

/workspace

-W

Verstehen Exitcodes

Versionskontrollenbefehle geben die folgenden Exitcodes zurückgegeben:

Exitcode

Definition

0

Erfolgreich.

1

Ein partieller Erfolg bedeutet, dass nicht alle und möglicherweise kein Vorgang erfolgreich ausgeführt werden konnte.

2

Nicht erkannter Befehl.

100

Kein Vorgang konnte erfolgreich ausgeführt werden.

Beispiel:

c:\code\SiteApp\Main\SolutionA\Project1\>tf checkout program1.cs program2.c

Wenn eine der Dateien, die Sie versuchen, auszuchecken, nicht vom Server, der Befehl zurückgibt 1, um partiellen Erfolg anzugeben vorhanden ist.