Befehl zum Abrufen

Artikel
05/16/2015

Dieser Befehl ruft entweder die neueste Version oder eine angegebene Version einer oder mehrerer Dateien oder Ordner von Team Foundation Server in den Arbeitsbereich ab (bzw. lädt diese herunter). Obwohl der Get-Befehl eine andere Benutzeroberfläche bereitstellt als Visual Studio (siehe Herunterladen (get) von Dateien vom Server), ist der Prozess weitgehend identisch.

Anforderungen: Siehe Berechtigungsreferenz für Team Foundation Server.

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

Parameter

Parameter	Beschreibung
/all	Wenn Sie einen lokalen Arbeitsbereich (empfohlen) verwenden, müssen Sie diese Option wahrscheinlich nicht verwenden. Sie können diese Option verwenden, um ein Element wiederherzustellen, das Sie versehentlich aus einem Serverarbeitsbereich gelöscht haben. Team Foundation Server 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 abgerufene Version bereits im Arbeitsbereich vorhanden ist. Diese Option ruft die Elemente unabhängig von den in diesem internen Datensatz enthalten Daten ab.
/force	Kombiniert /all und /overwrite.
itemspec	Gibt den Bereich der abzurufenden Elemente an. Sie können mindestens ein itemspec-Argument angeben. Wenn kein itemspec bereitgestellt wird, werden alle Elemente im aktuellen Arbeitsbereich rekursiv abgerufen. 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. Siehe Verwenden von Befehlen der Team Foundation-Versionskontrolle.
/noautoresolve	Standardmäßig versucht das System automatisch Alle automatisch auflösen (siehe Lösen von Konflikten der Team Foundation-Versionskontrolle). Geben Sie diese Option an, um dieses Standardverhalten zu deaktivieren.
/noprompt	Unterdrückt die Anzeige von Fenstern und Dialogfeldern und leitet Ausgabedaten zur Eingabeaufforderung um. Siehe Verwenden von Befehlen der Team Foundation-Versionskontrolle.
/overwrite	Wenn Sie einen lokalen Arbeitsbereich (empfohlen) verwenden, müssen Sie diese Option wahrscheinlich nicht verwenden. Auf dem Clientcomputer schreibbare Elemente (d. h., wenn das Schreibschutzattribut gelöscht ist) werden standardmäßig nicht abgerufen. Diese Option überschreibt das Standardverhalten und überschreibt ein schreibbares Element, sofern das Element nicht ausgecheckt wurde.
/preview	Zeigt das 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 itemspec nicht 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). Informationen zur Syntax finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

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

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

Ruft die neuesten Versionen aller Elemente im Arbeitsbereich ab. Beispielsweise kann der obige Befehl alle Dateien in $/SiteApp/Main/ rekursiv abrufen, einschließlich aller untergeordneten Ordner.

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

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

Ruft die neueste Version aller C#-Dateien (.cs) in c:\code\SiteApp\Main\SolutionA\Project1 ab.

Abrufen der neuesten Dateiversion

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

Ruft die neueste Version von program.cs in Project1 ab.

Abrufen einer spezifischen Dateiversion

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

Ruft Version 8 von program.cs in Project1 ab.

Abrufen der neuesten Version von zwei Dateien

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

Ruft die neueste Version von file1.cs und file2.cs in Project1 ab.

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

c:\code\SiteApp\Main>tf get /v:15

Synchronisiert den Arbeitsbereich zum Anpassen an die bei Erstellen von Changeset 15 vorhandene Codebase:

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

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

Synchronisiert den Arbeitsbereich zum Anpassen an die Elemente in der Codebase mit der Bezeichnung LastKnownGood:

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 im Arbeitsbereich gelöscht.

Arbeiten in Visual Studio

Herunterladen (get) von Dateien vom Server Rufen Sie Dateien und Ordnern mit Visual Studio ab.

Tipps

Wenn Sie mit einer neuen Aufgabe beginnen, empfiehlt sich möglicherweise das Ausführen von tf get (dies ist in allen Verzeichnissen im Arbeitsbereich möglich), um die neuesten Dateien vom Server herunterzuladen, bevor Sie die Dateien auschecken und mit der Arbeit anfangen.
Bei Bedarf erstellt dieser Befehl Ordner auf dem Datenträger, in denen die untergeordneten Elemente enthalten sind, die der Befehl herunterlädt.
Informationen zum Verlauf eines Elements können mit dem Befehl für den Verlauf und dem Changeset Command angezeigt werden.
Wenn Sie Bedenken hinsichtlich etwaiger Dateiänderungen im Arbeitsbereich haben, können Sie die /preview-Option verwenden, um die möglichen Änderungen anzuzeigen, ohne diese tatsächlich zu implementieren.
Konflikte können das Abrufen blockieren. Eine typische Konfliktursache ist das Abrufen von Elementen mit ausstehenden Änderungen. Sie können diese Konflikte mit dem Resolve Command lösen.