Unshelve-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Der TFVC-Befehl unshelve stellt abgelegte Dateirevisionen, Eincheckhinweise, Kommentare und Arbeitselementzuordnungen im aktuellen Arbeitsbereich wieder her. Sie können auch den Befehl unshelve verwenden, um ein vorhandenes Shelveset vom Server zu entfernen.

Voraussetzungen

  • So verwenden Sie den Befehl unshelve
    • Sie müssen die Berechtigung Lesen auf Zulassen festgelegt haben.
    • 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 Abgelegte Änderungen verwalten auf Zulassen festgelegt haben.

Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

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>

Identifiziert die Datei- oder Ordnerrevisionen für das Unshelven im aktuellen Arbeitsbereich. Wenn dieser Parameter nicht angegeben wird, wird für alle ausstehenden Änderungen in dem angegebenen Shelveset standardmäßig das Unshelven durchgeführt. Serverpfade sind nicht zulässig.

Weitere Informationen darüber, wie TFVC <item-spec>-Werte analysiert, um festzustellen, welche Elemente im Gültigkeitsbereich liegen, finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle – Verwenden von Optionen zum Ändern der Funktionsweise von Befehlen.

Hinweis

Sie können mehr als ein <item-spec>-Argument angeben.

<username>

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

<password>

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

Tastatur

Option

Beschreibung

/move

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

Sie können ein Shelveset auch mithilfe des shelve-Befehls löschen.

/recursive

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

/noprompt

Gibt an, dass Sie von TFVC nicht zur Eingabe aufgefordert werden sollen.

/login

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

Bemerkungen

Der unshelve-Befehl des Hilfsprogramms tf ruft entweder alle abgelegten Dateirevisionen oder eine definierte Teilmenge aller abgelegten Dateirevisionen vom Azure DevOps-Server ab. Der Befehl speichert dann die Revisionen im aktuellen Arbeitsbereich.

Für das Unshelven von Elementen darf es für das Element im Zielarbeitsbereich keine ausstehenden Revisionen geben.

Wenn Sie das Unshelven für ein Shelveset durchführen, stellt TFVC jede abgelegte Revision im Zielarbeitsbereich als ausstehende Änderung wieder her, sofern die Revision nicht mit einer Änderung in Konflikt steht, die im Arbeitsbereich bereits ausstehend war. Weitere Informationen zu den Vorgängen beim Unshelven des Shelvesets finden Sie unter Arbeiten mit Shelvesets.

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 dem Erstellen des Shelvesets auf dem Server eingecheckt wurden.

Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

Wiederverwenden abgelegter Änderungen

Wenn Sie abgelegte Revisionen in Ihren aktuellen Arbeitsbereich integrieren möchten, um fortlaufende Revisionen vorzunehmen, führen Sie das Unshelven für das gewünschte Shelveset durch. Als bewährte Methode sollten Sie auch die neueste Version Ihrer Dateien mit Versionskontrolle abrufen, nachdem Sie das Unshelven durchgeführt haben.

Unshelven und Überprüfen des Codes anderer Benutzer

Sie können für ein Shelveset auch das Unshelven durchführen, um Änderungen aus dem Arbeitsbereich eines anderen Benutzers zu überprüfen. Für das Unshelven aus diesem Grund haben Sie zwei Möglichkeiten:

  • Die erste Option ist geeignet, wenn die abgelegten und zugehörigen Elemente seit dem Erstellen des Shelvesets nicht oder nur geringfügig überarbeitet wurden. In diesem Fall können Sie die Basisversion aller zugehöriger 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, über den der andere Benutzer das Shelveset erstellt hat.

  • Die zweite Option ist geeignet, wenn seit dem Erstellen des Shelvesets viel Zeit vergangen ist oder sich mehrere Revisionen im Arbeitsbereich befunden haben. In diesem Fall können Sie die Version aller zugehörigen Elemente ab dem Datum und der Uhrzeit, zu der das Shelveset erstellt wurde, vom Server abrufen.

Sie können die abgelegten Änderungen eines anderen Benutzers unshelven, indem Sie den Benutzernamen an den Namen des Shelvesets anfügen. Sie können jedoch nur dann ein Shelveset vom Azure DevOps-Server entfernen, das 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 unshelven, führt TFVC die Unterschiede zwischen den Elementen nicht zusammen und ruft die Revision nicht in Ihren Arbeitsbereich ab.

Sie können ein Shelveset mithilfe von tf shelve /delete löschen. Weitere Informationen finden Sie unter Shelve-Befehl. Verwenden Sie tf unshelve /move, um ein Shelveset automatisch zu löschen, nachdem Sie für das gesamte Shelveset das Unshelven durchgeführt haben.

Beispiele

Im folgenden Beispiel wird das Dialogfeld Unshelve geöffnet, sodass Sie ein Shelveset im aktuellen Arbeitsbereich suchen und unshelven können. Sie haben im Dialogfeld auch die Möglichkeit, das Shelveset zu löschen, wenn das Unshelven abgeschlossen ist.

c:\>tf unshelve

Im folgenden Beispiel wird für das Shelveset „buddytest_1256“ im aktuellen Arbeitsbereich das Unshelven durchgeführt und es von Azure DevOps Server entfernt:

c:\>tf unshelve /move buddytest_1256