Shelve-Befehl (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022-
Der Befehl "Team Foundation Version Control" (TFVC) shelve speichert eine Reihe ausstehender Änderungen, zusammen mit ausstehenden Einchecknotizen, einem Kommentar und einer Liste der zugehörigen Arbeitsaufgaben auf einem Azure DevOps-Server, ohne sie tatsächlich einzuchecken.
Voraussetzungen
Wenn Sie den Befehl shelve verwenden möchten, um eine Regalmappe zu löschen, sei es ein Regalebesitzer, oder Ihre Verwalten von Änderungen Berechtigung muss auf Allowfestgelegt werden. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.
Syntax
tf shelve [/replace] [/comment:("comment"|@commentfile)] [shelvesetname] [/validate][/noprompt] [/login:username,[password]]
tf shelve [/move] [/replace] [/comment:("comment"|@commentfile)]
[/recursive] [shelvesetname] itemspec [/validate] [/noprompt] [/login:username,[password]]
tf shelve /delete shelvesetname[;owner] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parameter
Argumente
| Argument | Beschreibung |
|---|---|
<commentfile> |
Gibt einen Dateisystempfad einer Datei an, aus der Kommentare für das Regalset gelesen werden sollen. |
<comment> |
Gibt den Kommentar für die Regale an. |
<itemspec> |
Identifiziert die Dateien oder Ordner, die im Regal abgelegt werden sollen. Standardmäßig werden alle ausstehenden Änderungen im aktuellen Arbeitsbereich verschoben, wenn dieser Parameter nicht angegeben ist. Weitere Informationen dazu, wie Team Foundation die itemspec analysiert, um zu bestimmen, welche Elemente innerhalb des Gültigkeitsbereichs enthalten sind, finden Sie unter Verwenden von Optionen, um zu ändern, wie eine Befehlsfunktion. |
<shelvesetname> |
Gibt einen Namen an, mit dem das Regalet vom Azure DevOps-Server abgerufen werden kann. Sie können eine vorhandene Kombination aus shelvesetname und ownerangeben, aber nur, wenn /replace auch angegeben ist.Sie müssen einen Wert für diesen Parameter angeben. |
<owner> |
Identifiziert den aktuellen oder beabsichtigten Besitzer der Regale anhand des Benutzernamens. Standardmäßig wird dem aktuellen Benutzer der Besitz des Regalsets zugewiesen, wenn keins angegeben ist. |
<username> |
Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamenswert entweder als DOMAIN\username oder als usernameangeben. |
<TeamProjectCollectionUrl> |
Die URL der Projektsammlung, die die Dateien oder Ordner enthält, die Sie speichern möchten, z. B. http://myserver:8080/tfs/DefaultCollection/. |
Optionen
| Option | Beschreibung |
|---|---|
/new |
Der ausgewählte Status jeder ausstehenden Änderung, wie im Dialogfeld "Einchecken" von Visual Studio "Einchecken", der Kommentar, die zugehörigen Arbeitsaufgaben, die Einchecknotizen und das Außerkraftsetzen des Grunds für die Außerkraftsetzung der Eincheckrichtlinien, werden auf Ihrem Entwicklungscomputer als ausstehende Änderungen gespeichert, bis Sie sie einchecken. Die Option /new deaktiviert diese Eincheckmetadaten, bevor Sie einchecken. |
/move |
Entfernt ausstehende Änderungen aus dem Arbeitsbereich, nachdem der Schubladevorgang erfolgreich war. |
/replace |
Ersetzt das vorhandene Regalset durch denselben Namen und denselben Besitzer wie die von Ihnen angegebene. |
/delete |
Löscht die angegebenen Regale. Nur die Option /server kann mit dieser Option kombiniert werden. Wenn Sie die Option /noprompt nicht einschließen, wird eine Bestätigungsmeldung angezeigt, wenn die option /delete angegeben wird. |
/comment |
Fügt einen angegebenen Kommentar hinzu, der die geänderten Änderungen beschreibt. |
/recursive |
Regale aller Elemente im angegebenen Regalsatzordner, deren Unterordner und alle darin enthaltenen Elemente, wenn die von Ihnen bereitgestellte itemspec ein Ordner ist. |
/noprompt |
Unterdrückt alle Aufforderungen zur Eingabe von Ihnen. |
/validate |
Mit dieser Option wird das Kontrollkästchen Richtlinien und Einchecknotizen ausgewertet, bevor Kontrollkästchen im Dialogfeld Shelve - Quelldateien geöffnet wird. Wenn das Überprüfungskontrollkästchen aktiviert ist, wertet das Dialogfeld die Check-In-Richtlinien aus und überprüft, ob check-in-Notizen ausgefüllt wurden. Diese Option ist nützlich, wenn die Änderungen zur Überprüfung und Überprüfung durch eine andere Person übergeben werden. Ungültig bei Kombination mit /noprompt. |
/login |
Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps Server zu authentifizieren. |
/collection |
Gibt die Projektauflistung an. |
Bemerkungen
Der shelve-Befehl des Befehlszeilenprogramms tf sichert ausstehende Änderungen, eine Liste der zugehörigen Arbeitsaufgaben, laufende Check-In-Notizen und Kommentare in einem Regalet auf dem Azure DevOps-Server. Ein Regalet- ist ähnlich wie ein Changeet, das nicht auf den Server zugesichert ist. Wie ein Changeset kann ein Regalet von dem Server in einen lokalen Arbeitsbereich von jedem Benutzer abgerufen werden, der über ausreichende Berechtigungen verfügt.
Regale sind eine Alternative zum Einchecken ausstehender Änderungen, die noch nicht ausreichend getestet wurden. Verwenden Sie Regale, wenn Sie Ihre Arbeit unterbrechen möchten:
Geben Sie eine Reihe lokaler Arbeitsdateien für einen anderen Entwickler oder Tester frei, ohne die Änderungen am Versionssteuerungsserver zu überprüfen.
Legen Sie eine Gruppe ausstehender Änderungen vorübergehend außer Kraft, ohne sie einzuchecken, sodass Sie stattdessen an einem Problem mit höherer Priorität arbeiten können. Nachdem Sie die Arbeit an der Aufgabe mit hoher Priorität abgeschlossen haben, können Sie die geänderten Änderungen wiederherstellen, indem Sie den befehl Unshelve-Befehlverwenden.
Wenn Sie die Option /move einschließen, setzt der Befehl shelve jede geänderte Datei auf die Basisarbeitsbereichsversion zurück, die zuletzt vom Server auf den aktuellen Arbeitsbereich abgerufene Version zurück. Insbesondere für alle Elemente, die Sie im Regal ablegen, ist die option /move:
Verwendet
Undo, um die Änderungen rückgängig zu machen, die in den Regalen standen. Die Dateien, die ausstehende Ergänzungen waren, werden aus dem Arbeitsbereich gelöscht.Ruft die Basisarbeitsbereichsversionen aller Dateien ab, für die ausstehende Editionen vom Server in den aktuellen Arbeitsbereich vorhanden sind.
Markiert alle Elemente im aktuellen Arbeitsbereich schreibgeschützt.
Wenn Sie die Option /delete einschließen, entfernt TFVC dauerhaft das angegebene Regalet vom Azure DevOps-Server.
Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.
Beispiele
Im folgenden Beispiel wird ein neues Regalet auf dem Azure DevOps-Server namens Reflector_BuddyTesterstellt, dem Benutzer PatBesitzer zugewiesen, alle Elemente im aktuellen Arbeitsbereich werden an die neueste Version zurückgegeben, die während des letzten get Vorgangs heruntergeladen wurde, und legt einen schreibgeschützten Zustand fest:
c:\projects> tf shelve Reflector_BuddyTest;Pat /move
Das folgende Beispiel löscht das vorhandene Regalset new-feature vom Server, erstellt ein neues Regalset mit diesem Namen und behält alle ausstehenden Änderungen im aktuellen Arbeitsbereich bei:
c:\projects> tf shelve new-feature /replace
Im folgenden Beispiel wird ein Regalet namens HelloWorld_TestMe erstellt, das alle ausstehenden Änderungen an allen .cs Dateien im C:\projects Arbeitsordner und deren Unterordner enthält:
c:\projects> tf shelve HelloWorld_TestMe c:\projects\*.cs /recursive
Im folgenden Beispiel wird das HelloWorld_24 Regalset gelöscht:
c:\projects> tf shelve HelloWorld_24 /delete