Dir-Befehl

Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013

Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015 | Visual Studio 2013

Der Befehl dir zeigt den gesamten Inhalt des Servers für die Team Foundation-Versionskontrolle oder einen Teil davon an.

Voraussetzungen

Um den Dir-Befehl verwenden zu können, müssen Sie die Berechtigung Lesen auf Zulassenfestgelegt haben. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

tf dir itemspec [/version:versionspec] [/recursive] 
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]

Parameter

Argument

Argument

Beschreibung

Itemspec

Identifiziert die Datei oder den Ordner, zu der bzw. dem Informationen zurückgegeben werden sollen. Weitere Informationen dazu, wie Team Foundation Itemspecs analysiert, um zu bestimmen, welche Elemente innerhalb des Bereichs liegen, finden Sie unter Verwenden von Team Foundation-Versionskontrollbefehlen, Verwenden von Optionen zum Ändern der Funktionsweise eines Befehls.

Hinweis

Sie können mehrere Itemspec-Argumente angeben.

Versionspec

Der vom Benutzer bereitgestellte Wert für die Option /version. Weitere Informationen dazu, wie Team Foundation eine Versionsspezifikation analysiert, um zu bestimmen, welche Elemente innerhalb des Bereichs liegen, finden Sie unter Verwenden von Team Foundation-Versionskontrollbefehlen.

username

Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamenwert als DOMAIN\UserName oder UserNameangeben.

TeamProjectCollectionUrl

Die URL der Projektsammlung, die eine oder mehrere Dateien oder Ordner enthält, zu denen Sie Informationen anzeigen möchten (z. B. http://myserver:8080/tfs/DefaultCollection/).

Option

Option

Beschreibung

/version

Gibt an, dass Team Foundation nur Dateien und Ordner einer bestimmten Version anzeigen soll.

/recursive

Zeigt alle Dateien und Unterordner im angegebenen Verzeichnis an.

/folders

Zeigt nur Ordner an.

/deleted

Zeigt gelöschte und vorhandene Elemente an. Auf die gelöschten Elemente wird gefolgt von ; X3, wobei 3 die Lösch-ID ist.

/login

Gibt den Benutzernamen und das Kennwort für die Authentifizierung des Benutzers mit Azure DevOps an.

/collection

Gibt die Projektauflistung an.

Hinweise

Der Befehl dir wird für die Serverkopien der Team Foundation-Versionskontrolle von Dateien ausgeführt, nicht für die lokalen Kopien. Der Befehl verwendet den lokalen zugeordneten Ordner, um den entsprechenden Serverpfad für die Team Foundation-Versionskontrolle zu suchen. Verwenden Sie diesen Befehl, um den Team Foundation-Versionskontrollserver zu untersuchen und Dateien zu identifizieren, die Sie möglicherweise abrufen müssen.

Weitere Informationen zum Suchen des Tf-Befehlszeilenprogramms finden Sie unter Verwenden von Team Foundation-Befehlen für die Versionskontrolle.

Beispiele

Im folgenden Beispiel wird eine Liste mit Dateien, Ordnern, Unterordnern und den darin enthaltenen Dateien im Serverordner der Team Foundation-Versionskontrolle angezeigt, der c:\projects zugeordnet ist. Die Anzahl der Elemente wird ebenfalls aufgeführt. Weitere Informationen zum Anzeigen und Bearbeiten von Arbeitsordnerzuordnungen finden Sie unter Arbeitsbereichsbefehl und Arbeitsordnerbefehl.

c:\projects>tf dir /recursive

Im folgenden Beispiel werden alle Serverdateien der Team Foundation-Versionskontrolle unter diesem Pfad angezeigt. Der Unterordner "314dir" muss nicht im lokalen Ordner vorhanden sein.

c:\projects>tf dir 314dir

Im folgenden Beispiel wird die Version der Dateien mit der Bezeichnung "Meine Bezeichnung" im Serverpfad der Team Foundation-Versionskontrolle angezeigt. Der Unterordner "314dir" muss nicht im lokalen Ordner vorhanden sein.

c:\projects>tf dir /version:L"My label" 314dir

Im folgenden Beispiel werden alle Ordner im Stammverzeichnis des Team Foundation-Versionskontrollservers angezeigt. Der lokale Arbeitsordner wird ignoriert, da einen Serverpfad der $/ Team Foundation-Versionskontrolle bezeichnet.

c:\projects>tf dir /folders $/

Im folgenden Beispiel werden alle Dateien und Ordner auf dem Team Foundation-Versionskontrollserver aufgelistet.

c:\projects>tf dir /recursive $/

Im folgenden Beispiel werden alle Elemente und gelöschten Elemente im aktuellen Ordner zusammen mit ihren Lösch-IDs aufgelistet.

c:\projects>tf dir /deleted