Undo-Befehl (Team Foundation-Versionskontrolle)

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

Visual Studio 2019 | Visual Studio 2022

Der undo-Befehl der Team Foundation-Versionskontrolle (TFVC) verwirft eine oder mehrere ausstehende Änderungen an Dateien oder Ordnern.

Voraussetzungen

Standardmäßig verfügen die Mitglieder der Projektgruppe Mitwirkende über die Berechtigung, zu einem Repository beizutragen und den undo-Befehl in ihren eigenen Arbeitsbereichen zu verwenden. Um ausstehende Änderungen im Arbeitsbereich eines anderen Benutzers rückgängig zu machen, müssen Sie die Berechtigung Arbeitsbereiche verwalten auf Zulassen festgelegt haben. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf undo [/workspace:<workspace-name>[;<workspace-owner>]]
[/recursive] <item-specification> [/noprompt] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>]

Parameter

Parameter

BESCHREIBUNG

/collection:<team-project-collection-url>

Gibt die URL der Projektsammlung an, die die Elemente enthält, z. B. https://myserver:8080/tfs/DefaultCollection.

Wenn Sie die /workspace-Option nicht verwenden, wird standardmäßig die Projektsammlung verwendet, die den Arbeitsbereich enthält, der das aktuelle Verzeichnis zuordnet.

<item-specification>

Gibt den Bereich der Elemente an. Sie können mehrere <item-specification>-Argumente angeben. Weitere Informationen zur Syntax finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/login

Gibt das zur Ausführung des Befehls zu verwendende Benutzerkonto an. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/noprompt

Unterdrückt die Anzeige von Fenstern und Dialogfeldern und leitet Ausgabedaten zur Eingabeaufforderung um. Weitere Informationen finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

/recursive

Änderungen an Elementen im angegebenen Verzeichnis und allen Unterverzeichnissen werden rekursiv rückgängig gemacht.

/workspace <workspace-name>[;<workspace-owner>]

Gibt den Namen des Arbeitsbereichs an, in dem ausstehende Änderungen rückgängig gemacht werden sollen. Wenn nicht angegeben, wird der Arbeitsbereich verwendet, der das aktuelle Verzeichnis zuordnet.

Sie können <workspace-owner> angeben, um eine ausstehende Änderung in einem Arbeitsbereich rückgängig zu machen, der zu einem bestimmten Benutzer gehört. Wenn Sie dieses Argument nicht angeben, wird standardmäßig der Arbeitsbereich verwendet, der dem aktuellen Benutzer gehört. Wenn Sie jedoch das /login-Argument mit einem Benutzernamen angeben, wird der Arbeitsbereich verwendet, der diesem Benutzer gehört. Sie müssen die Berechtigung UndoOther auf Zulassen festgelegt haben, um Änderungen im Arbeitsbereich eines anderen Benutzers rückgängig zu machen.

Hinweis

Sie können den undo-Befehl verwenden, um eine ausstehende Änderung in einem Remotearbeitsbereich rückgängig zu machen, der noch verwendet wird. Bevor Sie die Arbeit in diesem Arbeitsbereich fortsetzen, muss sich der Benutzer an dem Computer anmelden, der den Arbeitsbereich hostet, und die Elemente abrufen, die vom Undo-Befehl betroffen sind. Weitere Informationen zum get-Befehl und sein /all-Argument finden Sie unter Get-Befehl.

Bemerkungen

Für jedes Element, das eine ausstehende Änderung vom Typ Bearbeitung aufweist, wird mit dem undo-Befehl ermittelt, ob die Datei auf dem Datenträger geändert wurde. Wenn die Datei geändert wurde und die /noprompt-Option nicht angegeben wurde, werden Sie vom System aufgefordert, zu bestätigen, dass Sie fortfahren möchten. Wählen Sie auf der Tastatur:

  • N, um die Änderung beizubehalten.
  • J, um nur mit der aktuellen Änderung fortzufahren.
  • A, um mit dieser Datei und allen anderen geänderten Dateien, die erkannt werden, fortzufahren.

Der undo-Befehl entfernt alle Sperren für die angegebenen Elemente.

Beispiele

Mit dem folgenden Befehl werden ausstehende Änderungen an der Datei program.cs entfernt:

c:\code\SiteApp\Main\SolutionA\Project1>tf undo program.cs

Der folgende Befehl entfernt ausstehende Änderungen an allen Elementen im Ordner c:\code\SiteApp\Main und seinen Unterordnern:

c:\code\SiteApp\Main>tf undo * /recursive

Mit dem folgenden Befehl werden ausstehende Änderungen an der Datei program.cs in der angegebenen Sammlung und im Remotearbeitsbereich entfernt:

c:\>tf undo /collection:https://fabrikam-3:8080/tfs/DefaultCollection
/workspace:FABRIKAM-1;PatI $/SiteApp/Main/SolutionA/Project1/program.cs

Tipps

  • Um eine Liste der ausstehenden Änderungen im aktuellen Arbeitsbereich oder in einem Remotearbeitsbereich anzuzeigen, verwenden Sie den Befehl status. Weitere Informationen finden Sie unter Status-Befehl.
  • Sie können die Option /workspace und bei Bedarf auch die Option /collection verwenden, um Änderungen auf einem Remoteentwicklungscomputer rückgängig zu machen. Diese Funktion ist besonders dann nützlich, wenn eine Datei ausgecheckt und möglicherweise auf einem Entwicklungscomputer gesperrt wurde, auf den Sie nicht zugreifen können. Weitere Informationen finden Sie in der Erläuterung des /workspace-Arguments weiter oben in diesem Artikel.
  • Manchmal müssen Sie Ihren Arbeitsbereich bereinigen, z. B. wenn Ihre Arbeit durch eine dringendere Aufgabe unterbrochen wird. Wenn Sie die ausstehenden Änderungen beibehalten möchten, anstatt sie rückgängig zu machen, können Sie sie mithilfe des Befehls shelve anhalten. Weitere Informationen finden Sie unter Shelve-Befehl. Sie können auch die Position Ihrer offenen Fenster, Haltepunkte und anderer wichtiger Hinweise beibehalten. Weitere Informationen finden Sie unter Unterbrechen der Arbeit und Verwalten von Shelvesets.
  • Sie können nicht nur ausstehende Änderungen rückgängig machen, sondern auch Änderungen verwerfen, die bereits eingecheckt wurden. Weitere Informationen finden Sie unter Undelete-Befehl und Rollback-Befehl (Team Foundation-Versionskontrolle).