Get-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Der Befehl get der Team Foundation-Versionskontrolle (TFVC) ruft entweder die neueste Version oder eine angegebene Version einer oder mehrerer Dateien oder Ordner von Azure DevOps Server in den Arbeitsbereich ab oder lädt sie herunter. Der tf get-Befehl bietet zwar eine andere Benutzeroberfläche als Visual Studio, der Vorgang ist aber grundsätzlich der gleiche. Weitere Informationen zur Verwendung von Visual Studio zum Abrufen von Dateien und Ordnern finden Sie unter Herunterladen (Abrufen) von Dateien vom Server.

Voraussetzungen

Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force] [/remap]
[/recursive] [/preview] [/noautoresolve] [/noprompt]
[/login:username,[password]]

Parameter

Parameter

Beschreibung

/all

Sie können diese Option verwenden, um ein Element wiederherzustellen, das Sie versehentlich aus einem Serverarbeitsbereich gelöscht haben. Wenn Sie einen lokalen Arbeitsbereich verwenden, was empfohlen wird, ist es unwahrscheinlich, dass Sie diese Option verwenden müssen.

TFVC verwaltet einen internen Datensatz aller Elemente, die der Arbeitsbereich enthält, einschließlich der jeweiligen Version. Das Element wird beim Abrufen von Dateien standardmäßig nicht abgerufen, wenn der interne Datensatz auf dem Server angibt, dass die abzurufende Version bereits im Arbeitsbereich vorhanden ist. Diese Option ruft alle Elemente ab, unabhängig von den Daten, die der interne Datensatz enthält.

/force

Kombiniert /all und /overwrite.

<itemspec>

Gibt den Bereich der abzurufenden Elemente an. Sie können mehrere itemspec-Argumente angeben. Wenn keine itemspec angegeben wird, werden alle Elemente im aktuellen Arbeitsbereich rekursiv abgerufen.

Weitere Informationen zur Syntax finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/login <username>,[<password>]

Gibt das Benutzerkonto an, unter dem der Befehl ausgeführt wird. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/noautoresolve

Standardmäßig versucht das System automatisch, alle Konflikte durch Alle automatisch auflösen zu lösen. Weitere Informationen finden Sie unter Lösen von Konflikten der Team Foundation-Versionskontrolle. Geben Sie diese Option an, um dieses Standardverhalten zu deaktivieren.

/noprompt

Unterdrückt die Anzeige von Visual Studio-Fenstern und -Dialogfeldern und leitet Ausgabedaten an die Eingabeaufforderung um. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/overwrite

Auf dem Clientcomputer schreibbare Elemente (d. h. Elemente mit gelöschtem Schreibschutzattribut) werden standardmäßig nicht abgerufen. Diese Option setzt das Standardverhalten außer Kraft und überschreibt ein schreibbares Element, es sei denn, das Element ist ausgecheckt. Wenn Sie wie empfohlen einen lokalen Arbeitsbereich verwenden, ist es unwahrscheinlich, dass Sie diese Option verwenden müssen.

/preview

Zeigt das hypothetische Ergebnis an, ohne dass der get-Vorgang tatsächlich ausgeführt wird.

/recursive

Ruft rekursiv alle Elemente im angegebenen Verzeichnis und in sämtlichen Unterverzeichnissen ab. Wenn Sie keine itemspec angeben, wird diese Option impliziert.

/remap

Weitere Informationen erhalten Sie unter phkelley's blog: tf get /remap.

/version:<versionspec>

Gibt die maximale Version oder die minimalen und maximalen Versionen an, die in den Verlaufsdaten angezeigt werden soll(en). Der Standardwert ist /version:T (die neueste Version).

Weitere Informationen zur Syntax finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Bemerkungen

  • Wenn Sie eine neue Aufgabe beginnen, sollten Sie tf get ausführen, um die neuesten Dateien vom Server herunterzuladen, bevor Sie Dateien auschecken und mit der Arbeit beginnen. Sie können tf get aus jedem Ordner in Ihrem Arbeitsbereich ausführen.

  • Bei Bedarf erstellt tf get zur Aufnahme der untergeordneten Elemente, die der Befehl herunterlädt, Ordner auf dem Datenträger.

  • Sie können Informationen zur Versionsgeschichte eines Elements anzeigen, indem Sie den Befehl Versionsgeschichte und den Befehl Changeset verwenden.

  • Wenn Sie Bedenken hinsichtlich etwaiger Dateiänderungen im Arbeitsbereich haben, können Sie die /preview-Option verwenden, um die hypothetischen Änderungen anzuzeigen, ohne sie tatsächlich zu implementieren.

  • Konflikte können Ihr get blockieren. Eine typische Konfliktursache ist das Abrufen von Elementen mit ausstehenden Änderungen. Sie können diese Konflikte mit dem Resolve-Befehl lösen.

Beispiele

In allen folgenden Beispielen wird angenommen, dass $/SiteApp/Main/ im Arbeitsbereich c:\code\SiteApp\Main\ zugeordnet ist.

Abrufen der neuesten Version aller Elemente in einem Arbeitsbereich

Standardmäßig ruft der tf get-Befehl die neuesten Versionen aller Elemente im Arbeitsbereich ab. Beispielsweise ruft der folgende Befehl alle Dateien in $/SiteApp/Main/ rekursiv ab, einschließlich aller untergeordneten Ordner.

c:\code\SiteApp\Main>tf get

Rekursives Abrufen der neuesten Version der Elemente eines bestimmten Typs in einem Ordner

Im folgenden Beispiel wird die neueste Version aller C#-Dateien in c:\code\SiteApp\Main\SolutionA\Project1 abgerufen.

c:\code\SiteApp\Main\SolutionA\Project1>tf get *.cs /recursive

Abrufen der neuesten Dateiversion

Im folgenden Beispiel wird die neueste Version von program.cs in Project1 abgerufen.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs

Abrufen einer spezifischen Version einer Datei

Im folgenden Beispiel wird Version 8 von program.cs in Project1 abgerufen.

c:\code\SiteApp\Main\SolutionA\Project1>tf get program.cs;8

Abrufen der neuesten Version von zwei Dateien

Im folgenden Beispiel werden die neuesten Versionen von file1.cs und file2.cs in Project1 abgerufen.

c:\code\SiteApp\Main\SolutionA\Project1>tf get file1.cs file2.cs

Synchronisieren eines Arbeitsbereichs zur Anpassung an eine Version der Team-Codebase

Im folgenden Beispiel wird der Arbeitsbereich zur Anpassung an die beim Erstellen von Changeset 15 vorhandene Codebase synchronisiert:

c:\code\SiteApp\Main>tf get /v:15
  • Der Name und Inhalt eines jeden Elements im Arbeitsbereich wird in Anpassung an den auf dem Server vorhandenen Zustand geändert.
  • Elemente, die nach diesem Changeset gelöscht wurden, werden im Arbeitsbereich wiederhergestellt.
  • Elemente, die nach diesem Changeset hinzugefügt wurden, werden im Arbeitsbereich gelöscht.

Synchronisieren eines Arbeitsbereichs zur Anpassung an eine bezeichnete Version der Team-Codebase

Im folgenden Beispiel wird der Arbeitsbereich zum Anpassen an die Elemente in der Codebase mit der BezeichnungLastKnownGood synchronisiert:

c:\code\SiteApp\Main>tf get /v:LLastKnownGood
  • Der Name und Inhalt eines jeden bezeichneten Elements im Arbeitsbereich wird in Anpassung an den auf dem Server vorhandenen Zustand geändert.
  • Bezeichnete Elemente, die gelöscht wurden, werden im Arbeitsbereich wiederhergestellt.
  • Nicht bezeichnete Elemente auf dem Server werden aus dem Arbeitsbereich gelöscht.