Freigeben über

Befehl "Unshelve" (Team Foundation Version Control)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022-

Der Befehl "Team Foundation Version Control" (TFVC) unshelve wiederherstellen gespeicherte Dateirevisionen, Einchecken von Notizen, Kommentaren und Arbeitsaufgabenzuordnungen zum aktuellen Arbeitsbereich. Sie können auch den Befehl unshelve verwenden, um ein vorhandenes Regalet vom Server zu entfernen.

Voraussetzungen

  • So verwenden Sie den Befehl unshelve:
    • Lassen Sie die Berechtigung "Lesen" auf "zulassen" festgelegt.
    • Lassen Sie die Berechtigung für die Elemente in der Regalmappe auf Zulassen.
  • Um ein Regalet zu löschen, müssen Sie der Besitzer sein oder die Verwalten von Regaländerungen globalen Berechtigungssatz auf Allowhaben.

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 Befehls unshelve beschrieben.

Argumente

Argument

Beschreibung

<shelveset-name>

Gibt den Namen der zu wiederherstellenden Regale an.

<owner-name>

Gibt den Benutzernamen des Regaletbesitzers an.

<item-spec>

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

Weitere Informationen dazu, wie TFVC <item-spec> Werte analysiert, um zu bestimmen, welche Elemente sich innerhalb des Bereichs befinden, finden Sie unter Verwenden von Steuerelementbefehlen für die Team Foundation-Version – Verwenden von Optionen, um zu ändern, wie eine Befehlsfunktion.

Anmerkung

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

<username>

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

<password>

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

Optionen

Option

Beschreibung

/move

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

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

/recursive

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

/noprompt

Gibt an, dass TFVC Sie nicht zur Eingabe auffordert.

/login

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

Bemerkungen

Der unshelve Befehl des Befehlszeilenprogramms tf ruft entweder alle überarbeitungen der Klammern oder eine definierte Teilmenge aller gespeicherten Dateirevisionen vom Azure DevOps-Server ab. Der Befehl speichert dann die Überarbeitungen im aktuellen Arbeitsbereich.

Um ein Element abzusichern, darf es keine ausstehenden Überarbeitungen dafür im Zielarbeitsbereich geben.

Wenn Sie eine Regale nicht absichern, stellt TFVC jede geänderte Überarbeitung im Zielarbeitsbereich als ausstehende Änderung wieder her, solange die Überarbeitung nicht mit einer Änderung in Konflikt steht, die bereits im Arbeitsbereich aussteht. Weitere Informationen dazu, was während des unhelfen Prozesses geschieht, finden Sie unter Arbeiten mit Regalen.

Mit dem Befehl unshelve können Sie einzelne Dateirevisionen aus einem Regalet in Ihrem Arbeitsbereich wiederherstellen. Nachdem Sie den Befehl unshelve ausgeführt haben, führen Sie den befehl get aus, um alle Änderungen abzugleichen, die seit der Erstellung des Regalets auf dem Server eingecheckt wurden.

Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.

Papierkorbänderungen

Wenn Sie Regale in Ihren aktuellen Arbeitsbereich integrieren möchten, um fortlaufende Überarbeitungen vorzunehmen, enthelben Sie die gewünschte Regale. Als bewährte Methode erhalten Sie auch die neueste Version Ihrer versionsgesteuerten Dateien nach dem Enthelfen.

Nicht zu helfen und den Code eines anderen Benutzers zu überprüfen

Sie können auch eine Regale enthelben, um Änderungen aus dem Arbeitsbereich eines anderen Benutzers zu überprüfen. Um aus diesem Grund nicht zu helfen, haben Sie zwei Möglichkeiten:

  • Die erste Option ist geeignet, wenn die Regale und verwandten Elemente nicht überarbeitet wurden oder nur leicht überarbeitet wurden, seit die Regale erstellt wurden. In diesem Fall können Sie die Basisversion aller zugehörigen Elemente aus dem Arbeitsbereich des Regaletbesitzers 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, von dem der andere Benutzer die Regale erstellt hat.

  • Die zweite Option ist geeignet, wenn seit der Erstellung des Regalsets eine erhebliche 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 Regalsets vom Server abrufen.

Sie können die änderung des Regals eines anderen Benutzers aufheben, indem Sie den Benutzernamen an den Namen der Regale anfügen. Sie können jedoch nur ein Regalet 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 Überarbeitung nicht in Ihren Arbeitsbereich ab.

Sie können eine Regale mithilfe von tf shelve /deletelöschen. Weitere Informationen finden Sie unter Shelve-Befehl. Verwenden Sie tf unshelve /move, um eine Regale automatisch nach dem Enthelben der gesamten Regale zu löschen.

Beispiele

Im folgenden Beispiel wird das Dialogfeld unshelve geöffnet, sodass Sie ein Regalet im aktuellen Arbeitsbereich suchen und enthelben können. Sie haben auch eine Option im Dialogfeld, die Regale gelöscht zu lassen, wenn der nicht zu schließende Vorgang abgeschlossen ist.

c:\>tf unshelve

Im folgenden Beispiel wird das Regalset buddytest_1256 in den aktuellen Arbeitsbereich entfernt und aus Azure DevOps Server entfernt:

c:\>tf unshelve /move buddytest_1256