Comando Folderdiff (controllo della versione di Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Usare il comando TFVC folderdiff
per visualizzare e confrontare una rappresentazione visiva delle differenze tra i file in due cartelle del server, in una cartella del server e in una cartella locale o in due cartelle locali.
Prerequisiti
Per usare il folderdiff
comando, è necessario disporre dell'autorizzazione Lettura impostata su Consenti. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.
Sintassi
tf folderdiff [sourcePath] targetPath [/recursive] [/noprompt] [/collection:TeamProjectCollectionUrl] [/filter:filter] [/filterLocalPathsOnly] [/login:username,[password]] [/view:same,different,sourceOnly,targetOnly]
Parametri
Argomenti
Argomento
Descrizione
<sourcePath>
Percorso di origine locale o server nell'operazione di confronto. Se questo argomento non viene fornito ed targetPath
è il percorso mappato locale, sourcePath
è il percorso del server a cui esegue il mapping.
<targetPath>
Percorso di destinazione locale o server nell'operazione di confronto.
<filter>
Elenco delimitato da punto e virgola di maschere di filtro di inclusione ed esclusione per l'opzione /filter
. Il valore predefinito è *
o includere tutti. Per una descrizione dettagliata dei filtri e delle maschere, vedere la sezione Osservazioni.
<TeamProjectCollectionUrl>
URL della raccolta di progetti che contiene i file per i quali si desidera visualizzare e confrontare le differenze, ad esempio http://myserver:8080/tfs/DefaultCollection
.
<username>
Fornisce un valore all'opzione /login
. È possibile specificare un valore di nome utente come DOMAIN\username
o username
.
Opzioni
Opzione
Descrizione
/recursive
Facoltativo. Confronta completamente le due cartelle in modo ricorsivo.
/noprompt
Facoltativo. Viene eseguito tf folderdiff
senza visualizzare l'output nella finestra Differenza cartelle di Visual Studio. La finestra del prompt dei comandi visualizza invece l'output.
/filter
Facoltativo. Specifica un elenco di maschere di inclusione e filtro utilizzate per confrontare i nomi di file e cartelle da confrontare.
/filterLocalPathsOnly
Facoltativo. Specifica che verranno filtrati solo i percorsi locali, a meno che non esista il percorso del server corrispondente.
/view
Facoltativo. Specifica le informazioni da includere nell'output utilizzando un elenco delimitato da virgole dei valori seguenti:
same
visualizza i file con lo stesso contenuto nelle directory di origine e di destinazione.different
visualizza i file con contenuto diverso nelle directory di origine e di destinazione.sourceOnly
visualizza i file esistenti solo nella directory di origine.targetOnly
visualizza i file esistenti solo nella directory di destinazione.
Il valore predefinito è different,sourceOnly,targetOnly
.
/collection
Specifica la raccolta di progetti.
/login
Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.
Osservazioni:
La finestra del prompt dei comandi visualizza l'output se si specifica /noprompt
. In caso contrario, nella finestra Differenza cartella di Visual Studio viene visualizzato l'output.
Quando il sistema confronta la cartella mappata locale con la cartella del server a cui è mappato, l'output nella finestra Differenza cartella include un elenco di modifiche in sospeso. Inoltre, l'output nella finestra Differenza cartella indica se la cartella locale contiene o meno la copia più recente.
L'output visualizzato nella finestra del prompt dei comandi elenca tutti i file nelle cartelle nelle cinque sezioni seguenti:
- Elementi presenti solo nella cartella del server.
- Elementi presenti solo nella cartella locale.
- Elementi con contenuto diverso.
- Elementi con contenuto identico. È necessario specificare l'argomento
same
con l'opzione/view
. - Riepilogo.
Filtri di file e cartelle
Un filtro è un elenco ordinato di maschere dei nomi usate per corrispondere al nome dei file e delle cartelle da confrontare. Le maschere possono contenere il carattere jolly del punto interrogativo ?
in modo che corrisponda esattamente a un carattere e al carattere jolly asterisco *
in modo che corrisponda a zero o più caratteri.
Le maschere vengono delimitate in un filtro usando punti ;
e virgola. Le maschere di cartella devono terminare con una barra rovesciata \
. Per specificare una maschera di esclusione, anteporre alla maschera un punto !
esclamativo .
Il filtro si applica ai nomi di file e cartelle usando le regole seguenti:
Quando un filtro specifica le maschere di file e cartelle, le maschere di file e cartelle vengono separate in un elenco di maschera file e in un elenco di maschere di cartelle. Le maschere di file si applicano solo ai nomi di file. Le maschere di cartella si applicano solo ai nomi delle cartelle.
Per trovare una corrispondenza con il nome di un file o di una cartella, il comando confronta il nome con ogni maschera nel filtro nell'ordine in cui è stato specificato. Non appena il nome corrisponde a una maschera, il nome viene considerato una corrispondenza.
Se le maschere di file nel filtro contengono una maschera di inclusione, i file che non corrispondono ad alcuna maschera file vengono esclusi.
Se le maschere di file nel filtro contengono solo maschere di esclusione, vengono inclusi i file che non corrispondono ad alcuna maschera file.
Se le maschere di cartella nel filtro contengono una maschera di inclusione, le cartelle che non corrispondono a nessuna delle maschere di cartella vengono escluse.
Se le maschere di cartella nel filtro contengono solo maschere di esclusione, vengono incluse cartelle che non corrispondono a nessuna delle maschere di cartella.
Nella tabella seguente sono elencati esempi di maschera nome filtro.
Maschera nome | Descrizione |
---|---|
*.cs |
Corrisponde a tutti i file C#. |
My*.bmp |
Trova la corrispondenza con tutti i file bitmap che iniziano con My. |
!*.exe |
Esclude tutti i file eseguibili. |
!objd\ |
Esclude tutte le cartelle objd . |
Nella tabella seguente sono elencati esempi di filtro.
Filtra | Descrizione |
---|---|
*.cs;!objd\;!obj\;!bin\ |
Trova la corrispondenza con tutti i file C# tranne quelli nelle cartelle objd, obj o bin . |
!*.resx;!*.ini;!resources\;!*junk*\ |
Esclude tutti i file resx e .ini , tutti i file nella cartella resources e tutti i file in qualsiasi cartella con un nome che include la parola indesiderata. |
Per altre informazioni su come usare l'utilità della tf
riga di comando, vedere Usare i comandi di controllo della versione di Team Foundation.
Esempi
L'esempio seguente confronta i file nella cartella del server e una cartella locale, organizza i file nella cartella locale in modo ricorsivo e visualizza l'output nella finestra del prompt dei comandi.
tf folderdiff $/<serverFolder> F:\<localFolder> /recursive /noprompt