Befehl Unshelve

Aktualisiert: November 2007

Stellt zurückgestellte Dateirevisionen, Eincheckhinweise, Kommentare und Zuordnungen von Arbeitsaufgaben zum aktuellen Arbeitsbereich wieder her oder entfernt ein vorhandenes Shelveset vom Server.

Erforderliche Berechtigungen

Zur Verwendung des unshelve-Befehls muss sowohl die Berechtigung Lesen auf Zulassen als auch die Berechtigung Auschecken für die Elemente im Shelveset auf Zulassen festgelegt sein. Um ein Shelveset zu löschen, müssen Sie dessen Besitzer sein, oder die globale Berechtigung Abgelegte Änderungen verwalten muss auf Zulassen festgelegt sein. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

tf unshelve [/move] [shelvesetname[;ownername]] itemspec 
[/recursive] [/noprompt]

Parameter

Argument

Beschreibung

shelvesetname

Der Name des wiederherzustellenden Shelvesets.

ownername

Der Name des Shelveset-Besitzers.

Itemspec

Identifiziert die Datei- oder Ordnerrevisionen, die in den aktuellen Arbeitsbereich aufgenommen werden sollen. Wenn dieser Parameter nicht angegeben wird, werden alle ausstehenden Änderungen im angegebenen Shelveset standardmäßig aufgenommen. Serverpfade sind nicht zulässig.

Weitere Informationen zum Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen.

Option

Beschreibung

/move

Löscht das angegebene Shelveset nach erfolgreichem Abschluss des Aufnahmevorgangs vom Team Foundation Server. Diese Option kann nicht mit itemspec kombiniert werden.

Sie können ein Shelveset auch mit dem Befehl shelve löschen.

/recursive

Bei Angabe dieser Option werden rekursiv Entsprechungen für itemspec gesucht.

/noprompt

Bei Angabe dieser Option wird keine Eingabeaufforderung angezeigt.

Hinweise

Der Befehl unshelve des Befehlszeilenprogramms tf ruft alle zurückgestellten Dateirevisionen oder einen festgelegten Teil der zugestellten Dateirevisionen vom Team Foundation Server in den aktuellen Arbeitsbereich ab.

Für die Aufnahme eines Elements müssen für dieses keine ausstehenden Überarbeitungen im Zielarbeitsbereich vorhanden sein.

Wenn Sie ein Shelveset aufnehmen, stellt Team Foundation jede zurückgestellte Revision im Zielarbeitsbereich als eine ausstehende Änderung wieder her, sofern die Revision nicht zu Konflikten mit einer anderen Änderung führt, die im Arbeitsbereich bereits aussteht. Weitere Informationen über die Vorgänge beim Aufnahmevorgang finden Sie unter Arbeiten mit Versionskontrollshelvesets.

Sie können den Befehl unshelve zum Wiederherstellen einzelner Dateirevisionen aus einem Shelveset im Arbeitsbereich verwenden. Sie sollten nach dem Aufnehmen get ausführen, um einen Abgleich mit allen seit dem Erstellen des Shelvesets vorgenommenen Änderungen durchzuführen.

Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".

Wiederverwenden von zurückgestellten Änderungen

Wenn Sie zurückgestellte Revisionen in den aktuellen Arbeitsbereich integrieren möchten, um Revisionen durchzuführen, nehmen Sie das gewünschte Shelveset auf. Es wird empfohlen, nach dem Aufnehmen auch die letzte Version der Dateien abzurufen, die der Versionskontrolle unterliegen.

Aufnehmen und Überprüfen von Code anderer Benutzer

Sie können ein Shelveset auch aufnehmen, um Änderungen aus dem Arbeitsbereich eines anderen Benutzers zu überprüfen. Für die Aufnahme für diesen Zweck gibt es zwei Möglichkeiten.

  • Wenn die zurückgestellten Elemente und die Elemente, mit denen diese verknüpft sind, nicht überarbeitet bzw. seit der Erstellung des Shelvesets nur geringfügig überarbeitet wurden, können Sie die Basisversion aller verknüpften Elemente aus dem Arbeitsbereich des Shelvesetbesitzers abrufen. Verwenden Sie hierfür eine Variante des folgenden Befehls: tf get * /version;Wworkspacename, wobei workspacename der Name des Arbeitsbereichs ist, mit dem der andere Benutzer das Shelveset erstellt hat.

  • Wenn eine längere Zeitspanne vergangen ist oder seit der Erstellung des Shelvesets mehrere Revisionen im Arbeitsbereich vorhanden waren, rufen Sie die Versionen aller zugehörigen Elemente ab dem Datum der Erstellung des Shelvesets vom Server ab.

Sie können die zurückgestellte Änderung eines anderen Benutzers aufnehmen, indem Sie den Benutzernamen an den Shelvesetnamen anfügen. Sie können aber nur Shelvesets von anderen Benutzern vom Team Foundation Server entfernen, wenn Sie über die Berechtigung AdminShelvedChangesets verfügen.

Wenn Sie ein Element aufnehmen möchten, für das eine ausstehende Änderung im Zielarbeitsbereich vorhanden ist, führt Team Foundation die Unterschiede zwischen den Elementen nicht zusammen und ruft die Revision nicht in den Arbeitsbereich ab.

Sie können ein Shelveset mit tf shelve /delete löschen. Weitere Informationen finden Sie unter Befehl Shelve. Um ein Shelveset automatisch zu löschen, nachdem Sie das gesamte Shelveset aufgenommen haben, verwenden Sie tf unshelve /move.

Beispiele

Im folgenden Beispiel wird das Dialogfeld Code aufnehmen, um ein Shelveset zu suchen und in den aktuellen Arbeitsbereich aufzunehmen. Sie können das Shelveset in diesem Dialogfeld auch löschen, nachdem der Aufnahmevorgang abgeschlossen wurde.

c:\>tf unshelve

Im folgenden Beispiel wird das Shelveset buddytest_1256 in den aktuellen Arbeitsbereich aufgenommen und vom Team Foundation Server entfernt.

c:\>tf unshelve /move buddytest_1256

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Erweiterte Funktionalität der Versionskontrolle

Gewusst wie: Zurückstellen und Aufnehmen ausstehender Änderungen

Konzepte

Arbeiten mit Versionskontrollshelvesets

Referenz

Befehlszeilensyntax (Team System)

Befehl Shelve

Befehl Changeset

Weitere Ressourcen

Befehle des Befehlszeilendienstprogramms "Tf"