Folderdiff-Befehl (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022-
Verwenden Sie den BEFEHL TFVC folderdiff
, um eine visuelle Darstellung der Unterschiede zwischen Dateien in zwei Serverordnern, in einem Serverordner und einem lokalen Ordner oder in zwei lokalen Ordnern anzuzeigen und zu vergleichen.
Voraussetzungen
Wenn Sie den Befehl folderdiff
verwenden möchten, legen Sie die Berechtigung "Lesen" auf "zulassen" fest. Weitere Informationen finden Sie unter Standard-TFVC-Berechtigungen.
Syntax
tf folderdiff [sourcePath] targetPath [/recursive] [/noprompt] [/collection:TeamProjectCollectionUrl] [/filter:filter] [/filterLocalPathsOnly] [/login:username,[password]] [/view:same,different,sourceOnly,targetOnly]
Parameter
Argumente
Argument
Beschreibung
<sourcePath>
Der lokale oder Serverquellpfad im Vergleichsvorgang. Wenn dieses Argument nicht angegeben wird und targetPath
der lokale zugeordnete Pfad ist, sourcePath
ist der Serverpfad, dem es zugeordnet ist.
<targetPath>
Der lokale oder Serverzielpfad im Vergleichsvorgang.
<filter>
Eine durch Semikolons getrennte Liste mit Einschluss- und Ausschlussfiltermasken für die Option /filter
. Der Standardwert ist *
oder schließt alle ein. Eine detaillierte Beschreibung von Filtern und Masken finden Sie in Anmerkungen.
<TeamProjectCollectionUrl>
Die URL der Projektsammlung, die die Dateien enthält, für die Sie die Unterschiede anzeigen und vergleichen möchten, z. B. http://myserver:8080/tfs/DefaultCollection
.
<username>
Stellt einen Wert für die Option /login
bereit. Sie können einen Benutzernamenwert entweder als DOMAIN\username
oder als username
angeben.
Optionen
Option
Beschreibung
/recursive
Wahlfrei. Vergleicht die beiden Ordner rekursiv.
/noprompt
Wahlfrei. Führt tf folderdiff
aus, ohne die Ausgabe im Visual Studio Ordnerunterschied Fenster anzuzeigen. Im Eingabeaufforderungsfenster wird stattdessen die Ausgabe angezeigt.
/filter
Wahlfrei. Gibt eine Liste von Einschluss- und Filterformaten an, die verwendet werden, um mit den Namen der zu vergleichenden Dateien und Ordner übereinzugleichen.
/filterLocalPathsOnly
Wahlfrei. Gibt an, dass nur die lokalen Pfade gefiltert werden, es sei denn, der entsprechende Serverpfad ist vorhanden.
/view
Wahlfrei. Gibt an, welche Informationen in die Ausgabe eingeschlossen werden sollen, indem eine durch Trennzeichen getrennte Liste der folgenden Werte verwendet wird:
same
zeigt Dateien mit demselben Inhalt in Quell- und Zielverzeichnissen an.different
zeigt Dateien mit unterschiedlichen Inhalten in Quell- und Zielverzeichnissen an.sourceOnly
zeigt Dateien an, die nur im Quellverzeichnis vorhanden sind.targetOnly
zeigt Dateien an, die nur im Zielverzeichnis vorhanden sind.
Der Standardwert ist different,sourceOnly,targetOnly
.
/collection
Gibt die Projektauflistung an.
/login
Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.
Bemerkungen
Im Eingabeaufforderungsfenster wird die Ausgabe angezeigt, wenn Sie /noprompt
angeben. Andernfalls zeigt das Visual Studio Ordnerunterschied Fenster die Ausgabe an.
Wenn das System den lokalen zugeordneten Ordner mit dem Serverordner vergleicht, dem er zugeordnet ist, enthält die Ausgabe im Fenster Ordnerunterschied eine Liste der ausstehenden Änderungen. Außerdem teilt ihnen die Ausgabe im fenster Ordnerunterschied mit, ob der lokale Ordner die neueste Kopie enthält.
Die im Eingabeaufforderungsfenster angezeigte Ausgabe listet alle Dateien in den Ordnern in den folgenden fünf Abschnitten auf:
- Elemente, die nur im Serverordner vorhanden sind.
- Elemente, die nur im lokalen Ordner vorhanden sind.
- Elemente mit unterschiedlichen Inhalten.
- Elemente mit identischen Inhalten. Sie müssen das argument
same
mit der Option/view
angeben. - Zusammenfassung.
Datei- und Ordnerfilter
Ein Filter ist eine sortierte Liste von Namensmasken, die verwendet werden, um den Namen von Dateien und Ordnern zu vergleichen. Masken können das Fragezeichen ?
Wildcardzeichen enthalten, um genau einem Zeichen zu entsprechen, und das Sternchen *
Wildcardzeichen, um null oder mehr Zeichen zu entsprechen.
Sie trennen die Masken in einem Filter mithilfe von Semikolons ;
. Ordnermasken müssen in einem umgekehrten Schrägstrich \
enden. Um ein Ausschlussformat anzugeben, stellen Sie der Maske ein Ausrufezeichen !
voran.
Der Filter gilt für die Datei- und Ordnernamen mithilfe der folgenden Regeln:
Wenn ein Filter sowohl Datei- als auch Ordnermasken angibt, werden die Datei- und Ordnermasken in eine Dateiformatliste und eine Ordnerformatliste getrennt. Dateiformate gelten nur für Dateinamen. Ordnerformate gelten nur für Ordnernamen.
Um mit einem Datei- oder Ordnernamen übereinzugleichen, vergleicht der Befehl den Namen mit den einzelnen Masken im Filter in der angegebenen Reihenfolge. Sobald der Name mit einer Maske übereinstimmt, wird der Name als Übereinstimmung betrachtet.
Wenn die Dateimasken im Filter ein Einschlussformat enthalten, werden Dateien, die keiner der Dateiformate entsprechen, ausgeschlossen.
Wenn die Dateimasken im Filter nur Ausschlussmasken enthalten, werden Dateien, die keiner der Dateimasken entsprechen, einbezogen.
Wenn die Ordnermasken im Filter ein Einschlussformat enthalten, werden Ordner, die keiner der Ordnermasken entsprechen, ausgeschlossen.
Wenn die Ordnermasken im Filter nur Ausschlussmasken enthalten, werden Ordner, die keiner der Ordnerformate entsprechen, eingeschlossen.
In der folgenden Tabelle sind Beispiele für Filternamenmasken aufgeführt.
Namensformat | Beschreibung |
---|---|
*.cs |
Entspricht allen C#-Dateien. |
My*.bmp |
Gleicht alle Bitmapdateien ab, die mit Mybeginnen. |
!*.exe |
Schließt alle ausführbaren Dateien aus. |
!objd\ |
Schließt alle Ordner aus. |
In der folgenden Tabelle sind Filterbeispiele aufgeführt.
Filter- | Beschreibung |
---|---|
*.cs;!objd\;!obj\;!bin\ |
Gleicht alle C#-Dateien ab, mit Ausnahme der Dateien in , objoder bin Ordnern. |
!*.resx;!*.ini;!resources\;!*junk*\ |
Schließt alle RESX-- und .ini-Dateien aus, alle Dateien im Ressourcen Ordner und alle Dateien in jedem Ordner mit einem Namen, der das Wort Junk-enthält. |
Weitere Informationen zur Verwendung des Befehlszeilenprogramms tf
finden Sie unter Verwenden von Befehlen für die Versionskontrolle von Team Foundation.
Beispiele
Im folgenden Beispiel werden die Dateien im Serverordner und ein lokaler Ordner verglichen, die Dateien im lokalen Ordner rekursiv organisiert und die Ausgabe im Eingabeaufforderungsfenster angezeigt.
tf folderdiff $/<serverFolder> F:\<localFolder> /recursive /noprompt