Dir-Befehl (Team Foundation-Versionskontrolle)
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