Comando Dir (controllo della versione di Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Il dir
comando visualizza tutto o parte del contenuto del server per controllo della versione di Team Foundation (TFVC).
Prerequisiti
Per usare il comando, è necessario disporre dell'autorizzazione dir
Lettura impostata su Consenti. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.
Sintassi
tf dir itemspec [/version:versionspec] [/recursive]
[/folders] [/deleted] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]
Parametri
Argomenti
Argomento
Descrizione
<itemspec>
Identifica il file o la cartella per restituire informazioni su . Per altre informazioni sul modo in cui TFVC analizza itemspec
per determinare quali elementi si trovano nell'ambito, vedere Usare le opzioni per modificare il modo in cui un comando funziona.
Nota
È possibile specificare più itemspec
argomenti.
<versionspec>
Valore fornito dall'utente per l'opzione /version
. Per altre informazioni su come TFVC analizza una specifica di versione per determinare quali elementi si trovano all'interno del relativo ambito, vedere Usare i comandi di controllo della versione di Team Foundation.
<username>
Fornisce un valore all'opzione /login
. È possibile specificare un valore di nome utente come DOMAIN\username
o username
.
<TeamProjectCollectionUrl>
URL della raccolta di progetti che contiene uno o più file o cartelle su cui si desidera visualizzare informazioni, ad esempio http://myserver:8080/tfs/DefaultCollection/
.
Opzioni
Opzione
Descrizione
/version
Specifica che TFVC deve visualizzare solo file e cartelle di una determinata versione.
/recursive
Visualizza tutti i file e le sottocartelle nella directory specificata.
/folders
Visualizza solo le cartelle.
/deleted
Visualizza gli elementi eliminati e gli elementi esistenti. Gli elementi eliminati vengono seguiti con ;Xn
dove n
è l'ID di eliminazione.
/login
Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.
/collection
Specifica la raccolta di progetti.
Osservazioni:
Il dir
comando opera sulle copie dei file del server Azure DevOps, non sulle copie locali. Il comando usa la cartella mappata locale per individuare il percorso del server Azure DevOps appropriato. Usare questo comando per esplorare il server Azure DevOps e identificare i file che potrebbero essere necessari.
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
Nell'esempio seguente viene visualizzato un elenco di file, cartelle, sottocartelle e file nella cartella del server Azure DevOps a cui viene eseguito il mapping c:\projects . Viene elencato anche il numero di elementi. Per altre informazioni su come visualizzare e modificare i mapping delle cartelle di lavoro, vedere Comando dell'area di lavoro e comando Workfold.
c:\projects>tf dir /recursive
Nell'esempio seguente vengono visualizzati tutti i file del server Azure DevOps nel percorso 314dir . La sottocartella 314dir non deve esistere nella cartella locale.
c:\projects>tf dir 314dir
L'esempio seguente mostra la versione dei file etichettati My label
nel percorso del server Azure DevOps 314dir . La sottocartella 314dir non deve esistere nella cartella locale.
c:\projects>tf dir /version:L"My label" 314dir
Nell'esempio seguente vengono visualizzate tutte le cartelle nella radice del server Azure DevOps. La cartella di lavoro locale viene ignorata, perché $/
indica un percorso del server Azure DevOps.
c:\projects>tf dir /folders $/
L'esempio seguente elenca ogni file e cartella nel server Azure DevOps.
c:\projects>tf dir /recursive $/
Nell'esempio seguente vengono elencati tutti gli elementi nella cartella corrente, inclusi gli elementi eliminati con gli ID di eliminazione.
c:\projects>tf dir /deleted