Folderdiff-Befehl (Team Foundation-Versionskontrolle)
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Verwenden Sie den TFVC-Befehl 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
Um den folderdiff
-Befehl zu verwenden, müssen Sie die Leseberechtigung auf Zulassen festlegen. Weitere Informationen finden Sie unter TFVC-Standardberechtigungen.
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 Quellpfad oder Serverquellpfad im Vergleichsvorgang. Wenn dieses Argument nicht angegeben wird und targetPath
der lokal zugeordnete Pfad ist, ist sourcePath
der zugeordnete Serverpfad.
<targetPath>
Der lokale Zielpfad oder Serverzielpfad im Vergleichsvorgang.
<filter>
Eine durch Semikola getrennte Liste von Einschluss- und Ausschlussfiltermasken für die /filter
-Option. Der Standardwert ist *
oder alle einschließen. Eine ausführliche Beschreibung der Filter und Masken finden Sie unter Hinweise.
<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 Benutzernamen entweder als DOMAIN\username
oder als username
angeben.
Tastatur
Option
Beschreibung
/recursive
Optional. Vergleicht die beiden Ordner vollständig und rekursiv.
/noprompt
Optional. Führt tf folderdiff
aus, ohne die Ausgabe im Visual Studio-Fenster Ordnerunterschied anzuzeigen. Stattdessen wird die Ausgabe im Eingabeaufforderungsfenster angezeigt.
/filter
Optional. Gibt eine Liste der Einschluss- und Filtermasken an, die verwendet werden, um die Namen der zu vergleichenden Dateien und Ordner abzugleichen.
/filterLocalPathsOnly
Optional. Gibt an, dass nur die lokalen Pfade gefiltert werden, es sei denn, der entsprechende Serverpfad ist vorhanden.
/view
Optional. Gibt mithilfe einer durch Trennzeichen getrennten Liste der folgenden Werte an, welche Informationen in die Ausgabe aufgenommen werden sollen:
same
zeigt Dateien mit demselben Inhalt in sowohl in den Quell- als auch in den Zielverzeichnissen andifferent
zeigt Dateien mit verschiedenem Inhalt sowohl in den Quell- als auch in den Zielverzeichnissen ansourceOnly
zeigt Dateien an, die nur im Quellverzeichnis vorhanden sindtargetOnly
zeigt Dateien an, die nur im Zielverzeichnis vorhanden sind
Der Standardwert lautet different,sourceOnly,targetOnly
.
/collection
Gibt die Projektsammlung an.
/login
Gibt den Benutzernamen und das Kennwort an, um den Benutzer bei Azure DevOps zu authentifizieren.
Bemerkungen
Das Fenster der Eingabeaufforderung zeigt die Ausgabe an, wenn /noprompt
angegeben wird. Andernfalls wird die Ausgabe im Visual Studio-Fenster Ordnerunterschied angezeigt.
Wenn das System den lokalen zugeordneten Ordner mit dem zugeordneten Serverordner vergleicht, enthält die Ausgabe im Fenster Ordnerunterschied eine Liste der ausstehenden Änderungen. Außerdem erfahren Sie in der Ausgabe im Fenster Ordnerunterschied, 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 unterschiedlichem Inhalt
- Elemente mit übereinstimmendem Inhalt. Sie müssen das
same
-Argument mit der Option/view
angeben. - Zusammenfassung.
Filter für Dateien und Ordner
Ein Filter ist eine geordnete Liste von Namensmasken, die verwendet werden, um die Namen der zu vergleichenden Dateien und Ordner abzugleichen. Masken können das Fragezeichen-Platzhalterzeichen ?
enthalten, das genau einem Zeichen entspricht, und das Sternchen-Platzhalterzeichen *
, das 0 oder mehr Zeichen entspricht.
Sie trennen die Masken in einem Filter mithilfe von Semikola ;
. Ordnermasken müssen mit einem umgekehrten Schrägstrich \
enden. Zum Angeben einer Ausschlussmaske stellen Sie der Maske ein Ausrufezeichen !
voran.
Der Filter wird anhand der folgenden Regeln auf die Datei- und Ordnernamen angewendet:
Wenn ein Filter sowohl Datei- als auch Ordnermasken angibt, werden die Datei- und Ordnermasken in eine Dateimaskenliste und eine Ordnermaskenliste aufgeteilt. Dateimasken gelten nur für Dateinamen. Ordnermasken gelten nur für Ordnernamen.
Um einen Datei- oder Ordnernamen zuzuordnen, vergleicht der Befehl den Namen in der angegebenen Reihenfolge mit den einzelnen Masken im Filter. Sobald der Name mit einer Maske übereinstimmt, wird der Name als Übereinstimmung betrachtet.
Wenn die Dateimasken im Filter eine Einschlussmaske enthalten, werden Dateien ausgeschlossen, die keiner der Dateimasken entsprechen.
Wenn die Dateimasken im Filter nur Ausschlussmasken enthalten, werden Dateien einbezogen, die keiner der Dateimasken entsprechen.
Wenn die Ordnermasken im Filter eine Einschlussmaske enthalten, werden Ordner ausgeschlossen, die keiner der Ordnermasken entsprechen.
Wenn die Ordnermasken im Filter nur Ausschlussmasken enthalten, werden Ordner einbezogen, die keiner der Ordnermasken entsprechen.
In der folgenden Tabelle sind Beispiele für Filternamenmasken aufgeführt.
Namensmaske | Beschreibung |
---|---|
*.cs |
Entspricht allen C#-Dateien. |
My*.bmp |
Entspricht allen Bitmapdateien, die mit My beginnen. |
!*.exe |
Schließt alle ausführbaren Dateien aus. |
!objd\ |
Schließt alle objd-Ordner aus. |
In der folgenden Tabelle sind Filterbeispiele aufgeführt.
Filter | Beschreibung |
---|---|
*.cs;!objd\;!obj\;!bin\ |
Entspricht allen C#-Dateien, die sich nicht in den Ordnern objd, obj oder bin befinden. |
!*.resx;!*.ini;!resources\;!*junk*\ |
Schließt alle RESX- und INI-Dateien, alle Dateien im Order resources und alle Dateien in Ordnern aus, deren Name das Wort Junk enthält. |
Weitere Informationen zur Verwendung des Befehlszeilenhilfsprogramms tf
finden Sie unter Verwenden von Befehlen der Team Foundation-Versionskontrolle.
Beispiele
Im folgenden Beispiel werden die Dateien im Serverordner mit einem lokalen Ordner verglichen, die Dateien im lokalen Ordner rekursiv organisiert und die Ausgabe im Eingabeaufforderungsfenster angezeigt.
tf folderdiff $/<serverFolder> F:\<localFolder> /recursive /noprompt