Befehl Get
Ruft eine schreibgeschützte Kopie einer Datei vom Team Foundation Server in den Arbeitsbereich ab und erstellt auf dem Datenträger die enthaltenden Ordner.
tf get itemspec [/version:versionspec] [/all] [/overwrite] [/force]
[/preview] [/recursive] [/noprompt]
Parameter
| Argument | Beschreibung |
|---|---|
Itemspec |
Die abzurufende Datei oder der Ordner. Wenn keine Elementspezifikation angegeben wird, führt Team Foundation Server einen rekursiven Abrufvorgang des aktuellen Arbeitsbereichs durch. |
Versionspec |
Der vom Benutzer angegebene Wert für die /version-Option. Weitere Informationen über das Verfahren, mit dem Team Foundation Server durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax. |
| Option | Beschreibung |
|---|---|
/version |
Optionale Versionsspezifikation. Die Versionsspezifikation ist die Version des abzurufenden Elements. Sie können die Version durch Folgendes angeben:
|
/all |
Erzwingt das Abrufen aller Dateien, auch der nicht veralteten. |
/overwrite |
Überschreibt nicht schreibgeschützte Dateien, die nicht ausgecheckt wurden. |
/force |
Impliziert /all und /overwrite. |
/preview |
Zeigt das Ergebnis an, ohne dass der Get-Vorgang tatsächlich ausgeführt wird. |
/recursive |
Ruft rekursiv alle Elemente ab, die der itemspec entsprechen. |
/noprompt |
Unterdrückt alle Dialogfelder und Fehlermeldungen, die andernfalls im Verlauf dieses Vorgangs angezeigt werden. |
Hinweise
Der get-Befehl ruft Elemente vom Server in einen Arbeitsbereich ab. Wenn keine andere Version angegeben wurde, wird die letzte Serverversion abgerufen.
In einer Entwicklungsumgebung, die von einem Team genutzt wird, ist der Befehl Get der am häufigsten verwendete Befehl, da bei jedem Abrufen einer Datei im aktuellen Projekt eine Synchronisierung mit dem Team erfolgt, wodurch sichergestellt wird, dass Sie immer über die aktuellste Kopie der gemeinsamen Arbeit verfügen. Der Befehl get überschreibt keine Dateien, die Sie in das lokale Verzeichnis ausgecheckt haben. Je häufiger Sie den Befehl get in einer gemeinsamen Arbeitsumgebung verwenden, desto aktueller sind Dateien im gesamten Team. Der Grund hierfür ist, dass der lokale Arbeitsbereich bei jedem get-Vorgang mit den Änderungen aufgefüllt wird, die von Ihren Teammitgliedern auf dem Server eingecheckt wurden. Wenn Sie Ihren Arbeitsbereich mit einem Vorgang für das Abrufen der letzten Version bei jede Eincheckhinweis auf dem neuesten Stand halten, können Sie sehr schnell Unterschiede zwischen Ihrer Version eines Projekts und der Serverversion auflösen. Dadurch können Sie verhindern, Änderungen vorzunehmen, die möglicherweise nur schwer mit dem Server abzugleichen sind, wenn Sie ausstehende Änderungen einchecken.
Wenn während eines get -Vorgangs die Arbeitsbereichsversion mit der angeforderten Serverversion identisch ist, ersetzt der Team Foundation Server die Datei auf dem Datenträger nur, wenn die Option /all angegeben wurde. Mit der Option /overwrite können Sie das Überschreiben der aktuellen, schreibbaren Arbeitsbereichsversion durch die angegebene Serverversion erzwingen, um im Arbeitsbereich einen konsistenten Zustand zu erreichen, wenn dieser nicht mehr verwaltet werden kann. Dies tritt z. B. ein, wenn Sie aus Versehen mehrere Dateien auf dem Datenträger löschen oder überschreiben oder wenn der Computer von einem Virus befallen ist. Wenn Sie die Option /force übergeben, überschreibt der Team Foundation Server alle Elemente im Arbeitsbereich mit der letzten Serverversion, sofern Sie keine bestimmte Version angeben.
Wenn Sie einen Abrufvorgang ausführen, löscht Team Foundation Server alle eingecheckten Dateien, die auf dem Server gelöscht wurden, im lokalen Arbeitsbereich, nachdem Sie Ihren Arbeitsbereich zuletzt mit der Serverversion synchronisiert haben. Dateien, die auf dem Server umbenannt oder verschoben wurden, werden auch auf dem Datenträger verschoben, um die Änderungen auf dem Server widerzuspiegeln.
Mit der Option /preview können Sie den Befehl get ausführen, ohne den lokalen Arbeitsbereich zu aktualisieren. Damit können Sie überprüfen, welche Änderungen eintreten würden, wenn Sie den Abrufvorgang tatsächlich ausführen.
Hinweis
Gehen Sie beim Abrufen einzelner Dateirevisionen in den Arbeitsbereich umsichtig vor, insbesondere wenn sich der Zeitstempel erheblich von dem anderer zugehöriger Arbeitsbereichselemente unterscheidet.
Arbeitsbereiche mit zeitlich inkonsistenten Dateirevisionen können beim Einchecken möglicherweise nur schwer mit der letzten Version auf dem Server für die Quellcodeverwaltung in Team Foundation synchronisiert werden. Dies kann dazu führen, dass bei zukünftigen Eincheckvorgängen unbeabsichtigt Fehler im Build entstehen.
Bei einem Auscheckvorgang wird nicht die letzte Version der ausgecheckten Dateien abgerufen
Wenn Sie einen Abruf ausführen, um den Arbeitsbereich mit einem Satz von Dateien aufzufüllen, erstellen Sie einen konsistenten Snapshot der Quellcodeverwaltung. Normalerweise ist die Konfiguration der Quelle im System ein Snapshot von Dateien vom Server für die Quellcodeverwaltung in Team Foundation, von denen bekannt ist, dass sie zusammen verwendet, erstellt und getestet werden können.
Als in einem Arbeitsbereich arbeitender Entwickler wirken sich die Änderungen, die von anderen Entwicklern durchgeführt werden, nicht auf Ihren Arbeitsbereich aus. Sie können das Übernehmen von Änderungen anderer Entwickler steuern, indem Sie ggf. einen Abrufvorgang ausführen. Im Idealfall können Sie die vollständige Konfiguration der Quelle aktualisieren, nicht nur eine oder zwei Dateien, da Änderungen in einer Datei häufig von Änderungen in anderen Dateien abhängig sind. Sie müssen sicherstellen, dass Sie über einen konsistenten Snapshot der Quelle verfügen, der erstellt und getestet werden kann.
Deshalb wird bei einem Auscheckvorgang nicht die letzte Version der ausgecheckten Dateien abgerufen. Das Aktualisieren einer ausgecheckten Datei würde die Konsistenz des Snapshots gefährden und könnte zu einer Quellkonfiguration führen, die weder erstellt noch getestet werden kann. Stattdessen erzwingt der Team Foundation Server, dass Sie die letzte Version abrufen, bevor Sie Änderungen einchecken. Wenn Sie Änderungen einzuchecken versuchen und nicht über die neueste Kopie verfügen, werden Sie daher in einem Dialogfeld zum Auflösen von Konflikten aufgefordert.
Der Abrufvorgang
Wenn Sie einen Abrufvorgang ausführen, wird die Versionsnummer der einzelnen Elemente in der Arbeitsbereichsdefinition aufgezeichnet und auf dem Team Foundation Server gespeichert. Diese Version eines Elements wird als Basisarbeitsbereichsversion bezeichnet.
Wenn Sie den Befehl get für ein Element auf dem Server ausführen, das im Arbeitsbereich bereits ausgecheckt wurde, werden Sie aufgefordert, die Dateikonflikte zwischen dem Arbeitsbereich und der abgerufenen Serverversion aufzulösen. Weitere Informationen finden Sie unter Befehl Resolve.
Beispiele
Im folgenden Beispiel wird die letzte Version von 314.cs vom Server abgerufen. Wenn ausstehende Änderungen für 314.cs vorhanden sind, initiiert Team Foundation Server den Vorgang zum Auflösen von Konflikten, der Sie bei der Behandlung von Konflikten unterstützt.
C:\projects>tf get 314.cs
Im folgenden Beispiel wird die Version 8 von 1256.cs vom Server abgerufen.
Hinweis
1256.cs;8 ist äquivalent mit 1256.cs;C8. Standardmäßig wird die Differenzmengenversion verwendet, wenn Sie nach dem Semikolon nur eine Zahl angeben.
C:\>tf get 1256.cs;8
Im folgenden Beispiel werden die aktuellen Versionen aller nicht verdeckten Elemente aus dem Serverordner und den Unterordnern in das Verzeichnis C:\Projekte abgerufen und gegebenenfalls lokale Ordner erstellt. Für weitere Informationen über das Verdecken und sichtbar Machen von Ordnern finden Sie unter Befehl Workfold.
C:\projects>tf get
Im folgenden Beispiel werden unterschiedliche Möglichkeiten für das Abrufen der Version von 1256.cs angegeben, die mit der Differenzmenge 1999 eingecheckt wurde.
c:\projects>tf get /version:C1999 1256.cs
- oder -
c:\projects>tf get 1256.cs;C1999
Im folgenden Beispiel wird die Version aller sichtbaren Elemente vom Server abgerufen, die auf dem Server vorhanden war, als die Differenzmenge 271 erstellt wurde.
c:\projects>tf get /version:C271
Im folgenden Beispiel wird build42 mit der Bezeichnung "build42" abgerufen. Damit wird der Arbeitsbereich mit der Bezeichnung abgeglichen, sofern keine ausstehenden Änderungen vorhanden sind. Alle Dateien, die sich nicht in der Bezeichnung befinden, werden vom lokalen Datenträger entfernt.
c:\projects>tf get /version:Lbuild42
Sicherheit
Wenn Sie den get-Befehl verwenden möchten, müssen Sie für jedes abgerufene Element die Lesen-Berechtigung auf Zulassen setzen und entweder über die Besitzrechte oder die Arbeitsbereiche verwalten-Berechtigung für den Zielarbeitsbereich verfügen. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
Siehe auch
Aufgaben
Exemplarische Vorgehensweise: Arbeiten mit der Team Foundation-Quellcodeverwaltung über die Befehlszeile
Gewusst wie: Abrufen der Quellcodeverwaltung für das Teamprojekt
Gewusst wie: Verdecken und Freilegen von Ordnern in einem Arbeitsbereich
Referenz
Befehl Resolve
Befehl Merge
Befehle Check-out und Edit
Befehl Checkin
Befehl Unshelve
Befehl Workfold