Dir-Befehl (Team Foundation-Versionskontrolle)

  • Artikel

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

Visual Studio 2019 | Visual Studio 2022

Der dir-Befehl zeigt den gesamten oder einen Teil des Inhalts des Servers für die Team Foundation-Versionskontrolle (TFVC) an.

Voraussetzungen

Um den dir-Befehl zu verwenden, müssen Sie die Berechtigung Lesen auf Zulassen festlegen. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.

Syntax

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

Parameter

Argumente

Argument

Beschreibung

<itemspec>

Identifiziert die Datei oder den Ordner, über die/den Informationen zurückgegeben werden sollen. Weitere Informationen darüber, wie TFVC die itemspec analysiert, um festzustellen, welche Elemente im Gültigkeitsbereich liegen, finden Sie unter 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 /version-Option. Weitere Informationen dazu, wie TFVC eine Versionsspezifikation analysiert, um zu bestimmen, welche Elemente in ihrem Gültigkeitsbereich liegen, finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.

<username>

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

<TeamProjectCollectionUrl>

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

Tastatur

Option

Beschreibung

/version

Gibt an, dass TFVC 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 Elemente und vorhandene Elemente an. Auf die gelöschten Elemente folgt ;Xn, wobei n die Lösch-ID ist.

/login

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

/collection

Gibt die Projektsammlung an.

Bemerkungen

Der dir-Befehl arbeitet mit den Azure DevOps-Serverkopien der Dateien, nicht mit den lokalen Kopien. Der Befehl verwendet den lokal zugeordneten Ordner, um den entsprechenden Azure DevOps-Serverpfad zu finden. Sie verwenden diesen Befehl, um den Azure DevOps-Server zu erkunden und Dateien zu identifizieren, die Sie möglicherweise abrufen müssen.

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

Beispiele

Im folgenden Beispiel wird eine Liste von Dateien, Ordnern, Unterordnern und Dateien im Azure DevOps-Serverordner angezeigt, die c:\projects zugeordnet sind. Die Anzahl der Elemente ist ebenfalls aufgeführt. Weitere Informationen zum Anzeigen und Bearbeiten von Arbeitsordnerzuordnungen finden Sie unter Workspace-Befehl und Workfold-Befehl.

c:\projects>tf dir /recursive

Das folgende Beispiel zeigt alle Azure DevOps-Serverdateien unter dem Pfad 314dir an. Der Unterordner 314dir muss nicht im lokalen Ordner vorhanden sein.

c:\projects>tf dir 314dir

Das folgende Beispiel zeigt die Version der Dateien mit der Bezeichnung My label im Azure DevOps-Serverpfad 314dir. 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 Azure DevOps-Servers angezeigt. Der lokale Arbeitsordner wird ignoriert, da $/ einen Azure DevOps-Serverpfad angibt.

c:\projects>tf dir /folders $/

Im folgenden Beispiel werden alle Dateien und Ordner auf dem Azure DevOps-Server aufgelistet.

c:\projects>tf dir /recursive $/

Im folgenden Beispiel werden alle Elemente im aktuellen Ordner aufgelistet, einschließlich gelöschter Elemente mit ihren Lösch-IDs.

c:\projects>tf dir /deleted