Befehl "Unshelve" (Team Foundation-Versionskontrolle)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Visual Studio 2019 | Visual Studio 2022

Mit dem Befehl Team Foundation-Versionskontrolle (TFVC) unshelve werden gespeicherte Dateirevisionen, Einchecknotizen, Kommentare und Zuordnungen von Arbeitselementen im aktuellen Arbeitsbereich wiederhergestellt. Sie können den unshelve Befehl auch verwenden, um ein vorhandenes Shelveset vom Server zu entfernen.

Voraussetzungen

  • So verwenden Sie den unshelve Befehl:
    • Die Leseberechtigung muss auf Zulassen festgelegt sein.
    • Sie müssen die Berechtigung Auschecken für die Elemente im Shelveset auf Zulassen festgelegt haben.
  • Um ein Shelveset zu löschen, müssen Sie dessen Besitzer sein oder die globale Berechtigung Änderungen verwalten auf Zulassen festgelegt haben.

Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.

Syntax

tf unshelve [/move] [<shelveset-name>[;<owner-name>]] <item-spec> 
[/recursive] [/noprompt][/login:<username>,[<password>]]

Parameter

In den folgenden Abschnitten werden Argumente und Optionen des unshelve Befehls beschrieben.

Argumente

Argument

Beschreibung

<shelveset-name>

Gibt den Namen des wiederherzustellenden Shelvesets an.

<owner-name>

Gibt den Benutzernamen des Besitzers des Shelvesets an.

<item-spec>

Gibt die Datei- oder Ordnerrevisionen an, die im aktuellen Arbeitsbereich aufgehoben werden sollen. Wenn dieser Parameter nicht enthalten ist, sind alle ausstehenden Änderungen im angegebenen Shelveset standardmäßig nicht enthalten. Serverpfade sind nicht zulässig.

Weitere Informationen dazu, wie TFVC Werte analysiert, um zu bestimmen, welche Elemente innerhalb des Gültigkeitsbereichs <item-spec> liegen, finden Sie unter Verwenden von Team Foundation-Versionskontrollbefehlen – Verwenden von Optionen zum Ändern der Funktionsweise eines Befehls.

Hinweis

Sie können mehrere <item-spec> Argumente angeben.

<username>

Stellt einen Wert für die /login Option bereit. Sie können diesen Wert als oder DOMAIN\<username><username>angeben.

<password>

Stellt einen Wert für die /login Option bereit.

Optionen

Option

Beschreibung

/move

Löscht das angegebene Shelveset vom Azure DevOps-Server, nachdem das Shelveset erfolgreich aufgehoben wurde. Diese Option kann nicht mit einem <item-spec> Wert kombiniert werden.

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

/recursive

Gibt an, dass der <item-spec> Wert rekursiv abgeglichen werden soll.

/noprompt

Gibt an, dass TFVC Sie nicht zur Eingabe auffordern soll.

/login

Gibt den Benutzernamen und das Kennwort an, um den Benutzer mit Azure DevOps zu authentifizieren.

Bemerkungen

Der unshelve Befehl des tf Befehlszeilenhilfsprogramms ruft entweder alle revisionen dateien oder eine definierte Teilmenge aller zurückgestellten Dateirevisionen vom Azure DevOps-Server ab. Der Befehl speichert dann die Revisionen im aktuellen Arbeitsbereich.

Um ein Element zu entfernen, darf es im Zielarbeitsbereich keine ausstehenden Revisionen dafür geben.

Wenn Sie ein Shelveset aufheben, stellt TFVC jede verworene Revision im Zielarbeitsbereich als ausstehende Änderung wieder her, solange die Revision nicht mit einer Änderung in Konflikt steht, die bereits im Arbeitsbereich aussteht. Weitere Informationen zu den Vorgängen während des Nicht-Schutzprozesses finden Sie unter Arbeiten mit Regalen.

Sie können den unshelve Befehl verwenden, um einzelne Dateirevisionen aus einem Shelveset in Ihrem Arbeitsbereich wiederherzustellen. Nachdem Sie den unshelve Befehl ausgeführt haben, führen Sie den get Befehl aus, um alle Änderungen abzugleichen, die seit der Erstellung des Shelvesets in den Server eingecheckt wurden.

Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms finden Sie unter Verwenden vontf Team Foundation-Versionskontrollbefehlen.

Recyceln von Regaländerungen

Wenn Sie Revisionen in Regalen in Ihren aktuellen Arbeitsbereich integrieren möchten, um fortlaufende Überarbeitungen vorzunehmen, entfernen Sie das gewünschte Shelveset. Als bewährte Methode sollten Sie auch die neueste Version Ihrer versionsgesteuerten Dateien abrufen, nachdem Sie die Lösung aufgehoben haben.

Entfernen und Überprüfen des Codes eines anderen Benutzers

Sie können auch ein Shelveset aufheben, um Änderungen aus dem Arbeitsbereich eines anderen Benutzers zu überprüfen. Um sich aus diesem Grund zu entfernen, haben Sie zwei Möglichkeiten:

  • Die erste Option ist geeignet, wenn die regalierten Elemente und zugehörigen Elemente nicht überarbeitet wurden oder nur leicht überarbeitet wurden, seit das Regalset erstellt wurde. In diesem Fall können Sie die Basisversion aller zugehörigen Elemente aus dem Arbeitsbereich des Shelvesetbesitzers abrufen. Um diese Option zu verwenden, führen Sie eine Variante des folgenden Befehls aus: tf get \* /version;W<workspace-name>, wobei <workspace-name> der Name des Arbeitsbereichs ist, aus dem der andere Benutzer das Shelveset erstellt hat.

  • Die zweite Option ist geeignet, wenn seit der Erstellung des Shelvesets eine beträchtliche Zeit vergangen ist oder mehrere Überarbeitungen im Arbeitsbereich vorhanden sind. In diesem Fall können Sie die Version aller zugehörigen Elemente ab dem Datum und der Uhrzeit der Erstellung des Shelvesets vom Server abrufen.

Sie können die gespeicherte Änderung eines anderen Benutzers aufheben, indem Sie den Benutzernamen an den Namen des Shelvesets anfügen. Sie können jedoch nur ein Shelveset vom Azure DevOps-Server entfernen, der von einem anderen Benutzer erstellt wurde, wenn Sie über die Berechtigung AdminShelvedChangesets verfügen .

Wenn Sie versuchen, ein Element mit einer ausstehenden Änderung im Zielarbeitsbereich zu entfernen, führt TFVC keine Unterschiede zwischen den Elementen zusammen und ruft die Revision nicht in Ihren Arbeitsbereich ab.

Sie können ein Shelveset mit tf shelve /deletelöschen. Weitere Informationen finden Sie unter Shelve-Befehl. Verwenden Sie tf unshelve /move, um ein Regalset automatisch zu löschen, nachdem das gesamte Regalset entfernt wurde.

Beispiele

Im folgenden Beispiel wird das Dialogfeld "Unshelve " geöffnet, sodass Sie ein Shelveset im aktuellen Arbeitsbereich finden und entfernen können. Sie haben auch eine Option im Dialogfeld, um das Shelveset zu löschen, wenn der Nichthelfvorgang abgeschlossen ist.

c:\>tf unshelve

Im folgenden Beispiel wird das Shelveset buddytest_1256 im aktuellen Arbeitsbereich aufgehoben und aus Azure DevOps Server entfernt:

c:\>tf unshelve /move buddytest_1256