Comando Workfold (controllo della versione di Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Il comando controllo della versione di Team Foundation (TFVC) workfold crea, modifica o visualizza informazioni sui mapping tra le cartelle dell'area di lavoro e le cartelle presenti nel server Azure DevOps per TFVC.
Prerequisiti
Per usare il workfold comando, è necessario essere il proprietario dell'area di lavoro specificata o implicita oppure disporre dell'autorizzazione amministrazione globale impostata su Consenti. Per altre informazioni, vedere Autorizzazioni tfvc predefinite.
Sintassi
tf workfold <local-folder> [/login:<username>,[<password>]]
tf workfold [/workspace:<workspace-name>] [/login:<username>,[<password>]]
tf workfold [/collection:<team-project-collection-url>] [/workspace:<workspace-name>] [/login:<username>,[<password>]]
<server-folder>
tf workfold [/map <server-folder> <local-folder>] [/collection:<team-project-collection-url>]
[/workspace:<workspace-name>][/login:<username>,[<password>]
tf workfold /unmap [/collection:<team-project-collection-url>] [/workspace:<workspace-name>]
[/recursive] (<server-folder>|<local-folder>) [/login:<username>,[<password>]]
tf workfold /cloak
<server-folder> [/workspace:<workspace-name>] [/collection:<team-project-collection-url>] [/login:<username>,[<password>]]
tf workfold /decloak <server-folder>
[/workspace:<workspace-name>] [/collection:<team-project-collection-url>][/login:<username>,[<password>]]
Parametri
Le sezioni seguenti descrivono argomenti e opzioni del workfold comando.
Argomenti
Argomento
Descrizione
<workspace-name>
Specifica il nome dell'area di lavoro su cui opera il comando con l'opzione /workspace .
<server-folder>
Specifica il nome di una cartella del server Azure DevOps.
<local-folder>
Specifica il nome di una cartella locale.
<team-project-collection-url>
URL della raccolta di progetti che contiene le cartelle da confrontare con le cartelle del server, https://myserver:8080/tfs/DefaultCollection/ad esempio .
<username>
Fornisce un valore all'opzione /login . È possibile specificare questo valore come DOMAIN\<username> o <username>.
<password>
Fornisce un valore all'opzione /login .
Opzioni
Opzione
Descrizione
/workspace
Specifica il nome dell'area di lavoro in cui lavorare.
/map
Specifica un'associazione tra una cartella locale e la cartella del server Azure DevOps. Per impostazione predefinita, il workfold comando usa questa opzione, anche se non specificato, a meno che /unmapnon sia specificato , /cloako /decloak .
/unmap
Specifica il mapping di cartelle da rimuovere dall'area di lavoro.
/cloak
Specifica che la cartella deve essere esclusa da qualsiasi azione di controllo della versione eseguita nell'area di lavoro.
/decloak
Rimuove una cartella in modo che la cartella possa essere recuperata nell'area di lavoro.
/collection
Specifica la raccolta di progetti.
/login
Specifica il nome utente e la password per autenticare l'utente con Azure DevOps.
Osservazioni:
È possibile usare il workfold comando dell'utilità della tf riga di comando per creare e modificare i mapping delle aree di lavoro. Un mapping dell'area di lavoro crea una cartella lato client in cui vengono recuperati tutti i file e le sottocartelle nella cartella del server Azure DevOps quando si esegue un'operazione tf get . L'operazione get non funziona se la cartella sul lato client è mascherata.
È anche possibile usare un carattere jolly asterisco (*) per eseguire il mapping di una cartella di Azure DevOps Server e dei relativi elementi immediati all'area di lavoro locale. Questo mapping viene spesso definito mapping di una singola cartella.
Per altre informazioni su come usare l'utilità della tf riga di comando, vedere Usare i comandi di controllo della versione di Team Foundation.
Opzioni per il mapping dell'area di lavoro
Un mapping dell'area di lavoro è un elenco di elementi attivi e mascherati. È possibile aggiungere elementi del server Azure DevOps all'elenco mappato nell'area di lavoro usando l'opzione /map . È anche possibile escludere un elemento dall'area di lavoro in modo esplicito usando l'opzione /cloak . È possibile nascondere solo gli elementi che dispongono di un elemento padre mappato. Il mantello è un modo efficace per migliorare la velocità delle operazioni batch get e per risparmiare spazio su disco.
Utilizzare il mantello con discrezione. Per evitare problemi di compilazione e integrazione, è consigliabile nascondere solo gli elementi che si sanno non rientrare nell'ambito dei progetti correnti e futuri, ad esempio immagini e file di documentazione esterni.
È possibile usare le /unmap opzioni e /decloak per eliminare in modo selettivo le voci mappate e mascherate dal mapping dell'area di lavoro.
Modalità di applicazione dei mapping delle aree di lavoro
Per impostazione predefinita, i mapping delle aree di lavoro vengono applicati in modo ricorsivo. Quando si esegue il mapping di una cartella locale a una cartella del server Azure DevOps, il sistema crea in modo implicito un mapping tra tutte le relative sottocartelle correnti e future.
Si supponga, ad esempio, di eseguire il mapping di $/projects a C:\projects. Aggiungere quindi un progetto denominato $/projects/project_one e quindi eseguire il get comando nell'area di lavoro. In questo scenario, tfvc crea automaticamente una cartella di lavoro locale denominata project_one nella directory C:\projects .
Nell'esempio seguente viene usato un carattere jolly asterisco (*) per eseguire il mapping di una cartella del server e dei relativi elementi immediati all'area di lavoro locale:
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
Nell'esempio seguente viene usato il workfold comando per eseguire l'override del mapping creato automaticamente tra $/projects/project_one e C:\projects\project_one:
tf workfold $/projects/project_one C:\DifferentWorkfold
Mapping sotto mantelli
I mapping delle cartelle non archiviate che si trovano sotto una cartella mascherata nella gerarchia del controllo della versione possono essere mappate all'area di lavoro locale.
Esempi
Nell'esempio seguente vengono visualizzati i mapping per l'area di lavoro in cui risiede c:\projects :
c:\projects>tf workfold
L'esempio seguente nasconde la cartella c:\projects\lib :
c:\projects>tf workfold /cloak c:\projects\lib
Nell'esempio seguente viene visualizzato il mapping per il file locale word.cs:
c:\projects>tf workfold word.cs
L'esempio seguente esegue il mapping della cartella C:\DifferentWorkfold alla cartella del server Azure DevOps $/projects/project_one e sostituisce il mapping dell'area di lavoro precedente per la cartella $/projects/project_one del server Azure DevOps:
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold