Befehl "Dir" (Versionskontrolle für Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022-
Mit dem Befehl dir werden alle oder einige Inhalte des Servers für team Foundation Version Control (TFVC) angezeigt.
Voraussetzungen
Wenn Sie den Befehl dir verwenden möchten, müssen Sie Berechtigung "Lesen" auf "zulassen" festlegen. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.
Syntax
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parameter
Argumente
Argument
Beschreibung
<itemspec>
Gibt die Datei oder den Ordner an, zu der Informationen zurückgegeben werden sollen. Weitere Informationen dazu, wie TFVC die itemspec analysiert, um zu bestimmen, welche Elemente sich innerhalb des Bereichs befinden, finden Sie unter Verwenden von Optionen zum Ändern der Funktionsweise eines Befehls.
Anmerkung
Sie können mehrere itemspec Argumente angeben.
<versionspec>
Der vom Benutzer bereitgestellte Wert für die option /version. Weitere Informationen dazu, wie TFVC eine Versionsspezifikation analysiert, um zu bestimmen, welche Elemente in ihrem Bereich enthalten sind, finden Sie unter Verwenden von Steuerelementbefehlen für die Team Foundation-Version.
<username>
Stellt einen Wert für die Option /login bereit. Sie können einen Benutzernamenwert entweder als DOMAIN\username oder als usernameangeben.
<TeamProjectCollectionUrl>
Die URL der Projektsammlung, die eine oder mehrere Dateien oder Ordner enthält, zu denen Informationen angezeigt werden sollen, z. B. http://myserver:8080/tfs/DefaultCollection/.
Optionen
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. Die gelöschten Elemente werden mit ;Xn gefolgt, 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 Projektauflistung an.
Bemerkungen
Der Befehl dir wird auf den Azure DevOps-Serverkopien von Dateien und nicht auf den lokalen Kopien ausgeführt. Der Befehl verwendet den lokalen zugeordneten Ordner, um den entsprechenden Azure DevOps-Serverpfad zu suchen. Mit diesem Befehl können Sie den Azure DevOps-Server erkunden und Dateien identifizieren, die Sie möglicherweise abrufen müssen.
Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.
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 wird ebenfalls aufgelistet. Weitere Informationen zum Anzeigen und Bearbeiten von Arbeitsordnerzuordnungen finden Sie unter Arbeitsbereichsbefehl und Arbeitsordnerbefehl.
c:\projects>tf dir /recursive
Im folgenden Beispiel werden alle Azure DevOps-Serverdateien im 314dir Pfad angezeigt. Der 314dir Unterordner muss nicht im lokalen Ordner vorhanden sein.
c:\projects>tf dir 314dir
Im folgenden Beispiel wird die Version der Dateien mit der Bezeichnung My label im 314dir Azure DevOps-Serverpfad angezeigt. Der 314dir Unterordner 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