Befehl Shelve
Aktualisiert: November 2007
Speichert einen Satz ausstehender Änderungen zusammen mit ausstehenden Eincheckhinweisen, einem Kommentar und einer Liste der zugeordneten Arbeitsaufgaben auf Team Foundation Server, ohne dass diese tatsächlich auf dem Versionskontrollserver eingecheckt werden.
Erforderliche Berechtigungen
Zur Verwendung des Kommandos shelve müssen Sie Besitzer des Shelveset sein oder über die Abgelegte Änderungen verwalten-Berechtigung verfügen. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.
tf shelve [/replace] [/comment:("comment"|@commentfile)] [shelvesetname[;owner] [/validate]
tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)]
[/recursive] shelvesetname[;owner] itemspec [/validate]
tf shelve /delete [/server:servername] shelvesetname[;owner] [/validate]
Parameter
Argument |
Beschreibung |
|---|---|
commentfile |
Gibt den Dateisystempfad einer Datei an, aus der die Kommentare für das Shelveset gelesen werden sollen. |
comment |
Gibt den Kommentar für das Shelveset an. |
servername |
Der vom Benutzer angegebene Wert für die /server-Option. |
itemspec |
Identifiziert die Dateien oder Ordner, die zurückgestellt werden sollen. Standardmäßig werden alle ausstehenden Änderungen im aktuellen Arbeitsbereich zurückgestellt, wenn dieser Parameter nicht angegeben wird. Weitere Informationen über das Verfahren, mit dem Team Foundation durch Analysieren der Elementspezifikationen die Elemente bestimmt, die innerhalb des Bereichs liegen, finden Sie unter Befehlszeilenoptionen. |
shelvesetname |
Gibt einen Namen an, über den das Shelveset vom Team Foundation Server abgerufen werden kann. Sie können jede mögliche Kombination aus Shelvesetname und Besitzer angeben. Dies gilt aber nur, wenn auch /replace angegeben wird. Sie müssen für diesen Parameter einen Wert geben. |
owner |
Identifiziert den aktuellen oder vorgesehenen Besitzer des Shelvesets durch den Benutzernamen. Standardmäßig wird der aktuelle Benutzer als Besitzer des Shelvesets festgelegt, sofern kein anderer Benutzer angegeben wird. |
Option |
Beschreibung |
|---|---|
/move |
Entfernt ausstehende Änderungen aus dem Arbeitsbereich, nachdem die Zurückstellung erfolgreich ausgeführt wurde. |
/replace |
Ersetzt das vorhandene Shelveset mit dem gleichen Namen und Besitzer des von Ihnen angegebenen Shelveset. |
/delete |
Löscht das angegebene Shelveset. Nur die Option /server kann mit dieser Option kombiniert werden. Wenn Sie die Option /noprompt nicht einfügen, wird eine Bestätigungsmeldung angezeigt, wenn die Option /delete angegeben wird. |
/comment |
Fügt einen angegebenen Kommentar hinzu, der die zurückgestellten Änderungen beschreibt. |
/recursive |
Stellt alle Elemente im angegebenen Shelvesetordner, den Unterordnern und sämtliche darin enthaltenen Elemente zurück, wenn die angegebene Elementspezifikation ein Ordner ist. |
/server |
Gibt den Server für die Team Foundation-Versionskontrolle an, auf dem das angegebene Shelveset erstellt, geändert oder gelöscht werden soll. |
/noprompt |
Unterdrückt alle Eingabeaufforderungen. |
/validate |
Nicht gültig in Verbindung mit /noprompt. Diese Option aktiviert das Kontrollkästchen für die Validierung beim Öffnen des Dialogfelds Code abgelegen - Quelldateien. Wenn das Kontrollkästchen für die Validierung aktiviert ist, wertet das Dialogfeld die Eincheckrichtlinien aus und prüft, ob die erforderlichen Eincheckhinweise ausgefüllt wurden. Diese Option ist nützlich, wenn die Änderungen zur Überprüfung und zum Einchecken an eine andere Person übergeben werden. |
Hinweise
Der Befehl shelve des Befehlszeilenprogramms tf sichert die ausstehenden Änderungen, eine Liste der zugeordneten Arbeitsaufgaben, aktuelle Eincheckhinweise und Kommentare in einem Shelveset auf dem Team Foundation Server. Ein Shelveset ähnelt einem Changeset, für die auf dem Server noch kein Commit ausgeführt wurde. Wie ein Changeset kann ein Shelveset von jedem Benutzer mit ausreichenden Berechtigungen vom Server in den lokalen Arbeitsbereich abgerufen werden.
Das Zurückstellen stellt eine Alternative zum Einchecken ausstehender Änderungen dar, die noch nicht ausreichend getestet wurden. Sie können Elemente zurückstellen, wenn Sie Ihre Arbeit unterbrechen möchten:
Arbeiten Sie zusammen mit anderen Entwicklern oder Testern an einem Satz lokaler Arbeitsdateien, ohne die Änderungen auf dem Versionskontrollserver einchecken zu müssen.
Stellen Sie eine Reihe ausstehender Änderungen für eine Weile zurück, ohne diese einzuchecken, sodass Sie an einem wichtigeren Problem arbeiten können. Nach Abschluss der Arbeit an der wichtigeren Aufgabe können Sie die zurückgestellten Änderungen mit dem Befehl Unshelve wiederherstellen.
Wenn Sie die Option /move verwenden, setzt der Befehl shelve alle zurückgestellten Dateirevisionen auf ihre Basisarbeitsbereichsversionen zurück, d. h., auf die letzte Version, die vom Servern in den aktuellen Arbeitsbereich abgerufen wurde. Mit der Option /move können Sie insbesondere sicherstellen, dass Folgendes für alle zurückgestellten Elemente gilt:
Verwendet Undo, um die abgelegten Änderungen rückgängig zu machen. Die Dateien, bei denen es sich um ausstehende Hinzufügungen gehandelt hat, werden aus dem Arbeitsbereich gelöscht.
Die Basisarbeitsbereichsversionen aller Dateien, für die ausstehende Bearbeitungen vorhanden sind, werden vom Server in den aktuellen Arbeitsbereich abgerufen.
Alle Elemente im aktuellen Arbeitsbereich werden als schreibgeschützt gekennzeichnet.
Wenn Sie die Option /delete verwenden, entfernt Team Foundation das angegebene Shelveset dauerhaft vom Team Foundation Server.
Weitere Informationen zur Suche nach dem Befehlszeilendienstprogramm tf finden Sie unter Befehle des Befehlszeilendienstprogramms "Tf".
Beispiele
Im folgenden Beispiel wird auf dem Team Foundation Server ein neues Shelveset mit der Bezeichnung Reflector_BuddyTest erstellt. Der Besitz wird dem Benutzer Hans zugewiesen, und anschließend werden alle Elemente im aktuellen Arbeitsbereich auf die während des letzten get-Vorgangs letzte heruntergeladene Version zurückgesetzt und als schreibgeschützt festgelegt.
c:\projects> tf shelve Reflector_BuddyTest;Hans /move
Im folgenden Beispiel wird das vorhandene Shelveset "new-feature" auf dem Server gelöscht, und es wird ein neues Shelveset mit demselben Namen erstellt. Sämtliche ausstehende Änderungen im aktuellen Arbeitsbereich werden beibehalten.
c:\projects> tf shelve new-feature /replace
Im folgenden Beispiel wird das Shelveset HelloWorld_TestMe erstellt, das sämtliche ausstehende Änderungen an allen CS-Dateien im Arbeitsordner C:\projects sowie in sämtlichen Unterordnern enthält.
c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive
Im folgenden Beispiel wird das HelloWorld_24-Shelveset gelöscht.
c:\projects> tf shelve HelloWorld_24 /delete
Siehe auch
Aufgaben
Gewusst wie: Zurückstellen und Aufnehmen ausstehender Änderungen
Konzepte
Arbeiten mit Versionskontrollshelvesets
Referenz
Befehlszeilensyntax (Team System)