Shelvesets-Befehl (Team Foundation-Versionskontrolle)

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

Visual Studio 2019 | Visual Studio 2022

Der shelvesets-Befehl der Team Foundation-Versionskontrolle (TFVC) zeigt Informationen über eine Reihe von geshelvten Änderungen an.

Voraussetzungen

Um den shelvesets-Befehl zu verwenden, müssen Sie die Berechtigung Lesen und die Berechtigung Auschecken für die Elemente in den Shelvesets auf Zulassen festgelegt haben. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf shelvesets [/owner:ownername] [/format:(brief|detailed)] [/collection:TeamProjectCollectionUrl]] [/login:username,[password]] shelvesetname

Parameter

Argumente

Argument Beschreibung
<ownername> Stellt einen Wert wie * oder DOMAIN\username für die /owner-Option bereit.
<shelvesetname> Der Name des Shelvesets.
<TeamProjectCollectionUrl> Die URL der Projektsammlung, die eine Reihe von geshelvten Änderungen enthält, zu denen Sie Informationen anzeigen möchten, z. B. http://myserver:8080/tfs/DefaultCollection.
<username> Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamenwert als DOMAIN\username oder username angeben.

Tastatur

Option Beschreibung
/owner Gibt einen oder mehrere Shelveset-Besitzer an. Sie können Platzhalterzeichen verwenden.
/format Gibt an, in welchem Format die Informationen zum Shelveset angezeigt werden sollen.

Brief zeigt den Namen des Shelvesets, den Namen des Benutzers, der es erstellt hat, und einen Kommentar zum Shelveset an, sofern vorhanden. Detailed zeigt den Namen, Besitzer und Kommentar für das Shelveset sowie eine Liste der zugeordneten Arbeitselemente und eventuelle Eincheckhinweise an. Der Standardwert lautet Brief.
/collection Gibt die Projektsammlung an.
/login Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.

Bemerkungen

Shelvesets werden mit dem Shelve-Befehl erstellt. Shelvesets werden auf dem Azure DevOps-Server gespeichert und können mithilfe des Unshelve-Befehls von jedem Benutzer, der über ausreichende Berechtigungen verfügt, in einen Arbeitsbereich abgerufen werden.

Im Gegensatz zu einem Changeset ist ein Shelveset eine Entität ohne Versionsinformationen. Wenn Sie oder ein anderer Benutzer die Elemente in einem Shelveset unshelven, mehrere Dateien bearbeiten und das Shelveset erneut shelven, erstellt TFVC keine neue Version der Elemente für zukünftige Vergleiche. TFVC führt keine Aufzeichnungen darüber, wer die Elemente wann und wie überarbeitet hat. Weitere Informationen zu der Entscheidung, ob eine Reihe von ausstehenden Änderungen geshelvt oder eingecheckt werden sollen, sowie eine allgemeine Übersicht über das Shelven finden Sie unter Arbeiten mit Shelvesets.

Ausführliche Informationen zu den einzelnen Quelldateirevisionen in einem bestimmten Shelveset erhalten Sie mit dem Status-Befehl mit der /shelveset-Option.

Sie können eine geshelvte Revision mit ihrer Basisversion vergleichen, ohne das Element in Ihrem Arbeitsbereich zu unshelven. Sie können dieses Feature verwenden, um eine schnelle Peercodeüberprüfung durchzuführen.

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

Beispiele

Das folgende Beispiel zeigt Informationen zum Shelveset BuddyTest_23 für den Azure DevOps-Server, dem das aktuelle Verzeichnis zugeordnet ist:

c:\projects>tf shelvesets BuddyTest_23

Im folgenden Beispiel werden die Shelvesets aufgelistet, die im Besitz von Pat sind:

c:\projects>tf shelvesets /owner:Pat

Im folgenden Beispiel werden Informationen zu allen Shelvesets auf dem Azure DevOps-Server angezeigt, denen das aktuelle Verzeichnis zugeordnet ist:

c:\projects>tf shelvesets /owner:*