Befehl Get
Ruft eine schreibgeschützte Kopie einer Datei vom Server für Team Foundation-Versionskontrolle in den Arbeitsbereich ab und erstellt auf dem Datenträger die enthaltenden Ordner.
Erforderliche Berechtigungen
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 hierzu finden Sie unter Team Foundation Server-Berechtigungen.
tf get [itemspec] [/version:versionspec] [/all] [/overwrite] [/force]
[/preview] [/recursive] [/remap] [/noprompt] [/login:username,[password]]
Parameter
Argument |
Beschreibungen |
|---|---|
Itemspec |
Die abzurufende Datei oder der Ordner. Wenn kein itemspec zur Verfügung gestellt wird, führt Team Foundation Server einen rekursiven GET-Vorgang auf allen Elementen aus, die im aktuellen Arbeitsbereich zugeordnet sind. .gif "Hinweis") Hinweis
Sie können mindestens ein Itemspec-Argument angeben.
|
Versionspec |
Der vom Benutzer angegebene Wert für die /version-Option. Weitere Informationen über das Verfahren, mit dem Team Foundation Server durch Analysieren der Versionsspezifikation die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilensyntax (Versionskontrolle). |
username |
Gibt einen Wert für die /login-Option an. Sie können als Wert für einen Benutzernamen entweder DOMÄNE\Benutzername oder Benutzername angeben. |
Option |
Beschreibungen |
|---|---|
/version |
Optionale Versionsspezifikation. Das versionspec bezeichnet 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 |
Kombiniert /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, die andernfalls im Verlauf dieses Vorgangs angezeigt werden. |
/remap |
Aktualisiert die lokale Zuordnung auf dem Server und lädt die Datei schneller neu herunter, wenn Sie dieselbe Datei bereits aus einer anderen Verzweigung heruntergeladen haben. Hinweis
Diese Option wird empfohlen, wenn Sie keine komplexe lokale Zuordnung verwenden und häufig zwischen Verzweigungen wechseln müssen.
|
/login |
Gibt den Benutzernamen und das Kennwort für die Benutzerauthentifizierung bei Team Foundation Server an. |
Hinweise
Der get-Befehl ruft Elemente vom Server in einen Arbeitsbereich ab. Wenn keine andere Version bereitgestellt wird, wird die letzte Serverversion abgerufen.
Wenn Sie in einer Teamentwicklungsumgebung arbeiten, ist get der Befehl, den Sie am häufigsten verwenden, da der Abruf jeder Datei im aktuellen Projekt mit dem Team synchronisiert wird. Dadurch wird sichergestellt, dass Sie die aktuellste Kopie freigegebener Arbeit besitzen. Der get-Befehl überschreibt keine Dateien, die Sie im lokalen Verzeichnis ausgecheckt haben. Je häufiger Sie den get-Befehl in einer Zusammenarbeitsumgebung ausführen, umso aktueller sind die lokalen Dateien im Vergleich zu denen des Teams. Das liegt daran, dass ein get-Vorgang den lokalen Arbeitsbereich mit Änderungen auffüllt, die von Teamkollegen in den Server eingecheckt wurden. Wenn Sie den Arbeitsbereich laufend aktualisieren, indem Sie immer einen get-Vorgang ausführen, wenn eine Eincheckbenachrichtigung angezeigt wird (zum Beispiel von Projektwarnungen), können Sie rasch Unterschiede zwischen der Version eines Projekts und der Serverversion des Projekts auflösen. Sie können Änderungen vermeiden, die unter Umständen nicht ohne Weiteres mit dem Server vereinbar sind, wenn Sie ausstehende Änderungen einchecken.
Wenn Ihre Arbeitsbereichsversion während eines get -Vorgangs mit der angeforderten Serverversion identisch ist, ersetzt Team Foundation Server die Datei nicht auf dem Datenträger, außer die /all-Option ist festgelegt. Mithilfe der /overwrite-Option kann die überschreibbare aktuelle Arbeitsbereichsversion mit einer angegebenen Serverversion erzwungenermaßen überschrieben werden, um den Arbeitsbereich in einen konsistenten Zustand zurückzuversetzen, wenn er nicht mehr verwaltet werden kann. Dies tritt z. B. manchmal auf, wenn Sie mehrere Dateien auf einem Datenträger löschen oder unbeabsichtigt überschreiben. Wenn Sie die /force-Option übergeben, überschreibt Team Foundation Server alle ausgecheckten Elemente im Arbeitsbereich mit der neuesten Serverversion, sofern Sie keine bestimmte Version angeben.
Wenn Sie einen get-Vorgang ausführen, löscht Team Foundation Server alle eingecheckten Dateien aus dem lokalen Arbeitsbereich, die nach der letzten Synchronisation des Arbeitsbereichs mit der Serverversion vom Server gelöscht wurden. Dateien, die auf dem Server umbenannt oder verschoben wurden, werden auch auf dem Datenträger verschoben, um die Änderungen auf dem Server widerzuspiegeln.
Mithilfe der /preview-Option können Sie den get -Befehl ausgeben, ohne den lokalen Arbeitsbereich zu aktualisieren. Auf diese Weise können Sie erkennen, was geschehen würde, wenn Sie tatsächlich GET-Vorgang ausführen.
Der Auscheckvorgang ruft bei Dateien, die ausgecheckt werden, nicht die letzte Version ab
Sie arbeiten als Entwickler in einem Arbeitsbereich. Änderungen, die von anderen Entwicklern durchgeführt werden, wirken sich nicht auf Ihren Arbeitsbereich aus. Sie steuern, wann Sie Änderungen von anderen Entwicklern übernehmen, indem Sie ggf. einen GET-Vorgang ausführen. Idealerweise können Sie die vollständige Konfiguration von der Versionskontrolle unterliegenden Dateien und nicht nur eine oder zwei Dateien aktualisieren, da Änderungen in einer Datei in der Regel von entsprechenden Änderungen an anderen Dateien abhängen. Sie müssen sicherstellen, dass Sie eine konsistente Momentaufnahme der der Versionskontrolle unterliegenden Dateien besitzen, die erstellt und getestet werden können.
Daher werden beim Auscheckvorgang für die ausgecheckten Dateien keine Aktionen zum Abrufen der aktuellen Objekte ausgeführt. Die Aktualisierung einer Datei, die ausgecheckt wird, würde gegen die konsistente Momentaufnahme verstoßen und könnte eine Konfiguration von der Versionskontrolle unterliegenden Dateien zur Folge haben, die nicht erstellt oder getestet werden können. Alternativ zwingt Sie Team Foundation Server zum Abrufen der letzten Version zu einem Zeitpunkt vor dem Einchecken der Änderungen, damit, wenn Sie die Änderungen einchecken und Sie die letzte Kopie nicht haben, Sie vom Dialogfeld zum Lösen von Konflikten die entsprechende Aufforderung erhalten.
Sie können auch Team Foundation Server so konfigurieren, dass beim Auschecken automatisch die aktuellsten Objekte abgerufen werden. Weitere Informationen finden Sie unter Konfigurieren von Auscheckeinstellungen.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilenhilfsprogramms "Tf".
Der Abrufprozess
Wenn Sie einen get-Befehl für ein Element vom Server ausgeben, das im Arbeitsbereich bereits ausgecheckt wurde, und die Serverversion geändert 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 Sie ausstehende Änderungen für "314.cs" haben, initiiert Team Foundation Server den Auflösungsprozess auf, der bei der Behandlung von Konflikten hilfreich ist.
C:\projects>tf get 314.cs
Im folgenden Beispiel wird die Version 8 von 1256.cs vom Server abgerufen.
Tipp
1256.cs;8 ist äquivalent mit 1256.cs;C8. Standardmäßig wird die Changesetversion 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 dem Changeset 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 das Changeset 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
Im folgenden Beispiel wird die Version auf dem Server zu einem bestimmten Datum und einer bestimmten Uhrzeit abgerufen.
c:\projects>tf get /version:D2008-01-21T16:00
Siehe auch
Aufgaben
Abrufen der Quelle für das Teamprojekt
Verdecken und Freilegen von Ordnern in einem Arbeitsbereich