Kommandot Workfold (Versionskontroll för Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Kommandot Team Foundation Version Control (TFVC) workfold skapar, ändrar eller visar information om mappningarna mellan dina arbetsytemappar och mapparna som finns på Azure DevOps-servern för TFVC.
Förutsättningar
Om du vill använda workfold kommandot måste du vara ägare till den angivna eller underförstådda arbetsytan eller ha den globala behörigheten Administrera arbetsytor inställd på Tillåt. Mer information finns i TFVC-standardbehörigheter.
Syntax
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>]]
Parametrar
I följande avsnitt beskrivs argument och alternativ för workfold kommandot.
Argument
Argument
Beskrivning
<workspace-name>
Anger namnet på arbetsytan som kommandot körs på med alternativet /workspace .
<server-folder>
Anger namnet på en Azure DevOps-servermapp.
<local-folder>
Anger namnet på en lokal mapp.
<team-project-collection-url>
URL:en för projektsamlingen som innehåller de mappar som du vill jämföra med servermappar, till exempel https://myserver:8080/tfs/DefaultCollection/.
<username>
Ger alternativet ett värde /login . Du kan ange det här värdet som antingen DOMAIN\<username> eller <username>.
<password>
Ger alternativet ett värde /login .
Alternativ
Alternativ
Beskrivning
/workspace
Anger namnet på arbetsytan som ska arbetas i.
/map
Anger en association mellan en lokal mapp och Azure DevOps-servermappen. Som standard workfold använder kommandot det här alternativet, även om det är ospecificerat, såvida inte /unmap, /cloakeller /decloak har angetts.
/unmap
Anger vilken mappmappning som ska ta bort från arbetsytan.
/cloak
Anger att mappen ska undantas från alla versionskontrollåtgärder som utförs på arbetsytan.
/decloak
Avskärmar en mapp så att mappen kan hämtas till arbetsytan.
/collection
Anger projektsamlingen.
/login
Anger användarnamn och lösenord för att autentisera användaren med Azure DevOps.
Kommentarer
Du kan använda kommandot för workfold tf kommandoradsverktyget för att skapa och redigera arbetsytemappningar. En mappning av arbetsytor skapar en mapp på klientsidan där alla filer och undermappar i Azure DevOps-servermappen hämtas när du kör en tf get åtgärd. Åtgärden get fungerar inte om mappen på klientsidan är dold.
Du kan också använda ett asterisktecken (*) för att mappa en Azure DevOps Server-mapp och dess omedelbara objekt till din lokala arbetsyta. Den här mappningen kallas ofta för en mappmappning.
Mer information om hur du använder tf kommandoradsverktyget finns i Använda Team Foundation-versionskontrollkommandon.
Alternativ för mappning av arbetsytor
En mappning av arbetsytor är en lista över aktiva och dolda objekt. Du kan lägga till Azure DevOps-serverobjekt i den mappade listan på arbetsytan med hjälp /map av alternativet . Du kan också exkludera ett objekt från arbetsytan explicit med hjälp av alternativet /cloak . Du kan bara dölja objekt som har en mappad överordnad. Kamouflage är ett effektivt sätt att förbättra hastigheten för batchåtgärder get och spara utrymme på disken.
Använd kamouflage med diskretion. För att undvika kompilerings- och integreringsproblem bör du bara dölja de objekt som du vet är utanför omfånget för dina aktuella och framtida projekt, till exempel bilder och externa dokumentationsfiler.
Du kan använda /unmap alternativen och /decloak för att selektivt ta bort mappade och dolda poster från arbetsytans mappning.
Hur arbetsytemappningar tillämpas
Som standard tillämpas arbetsytemappningar rekursivt. När du mappar en lokal mapp till en Azure DevOps-servermapp skapar systemet implicit en mappning mellan alla dess aktuella och framtida undermappar.
Anta till exempel att du mappar $/projects till C:\projects. Därefter lägger du till ett projekt med namnet $/projects/project_one och kör get sedan kommandot på arbetsytan. I det här scenariot skapar TFVC automatiskt en lokal arbetsmapp med namnet project_one i katalogen C:\projects .
I följande exempel används ett asterisktecken (*) jokertecken för att mappa en servermapp och dess omedelbara objekt till din lokala arbetsyta:
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
I följande exempel används workfold kommandot för att åsidosätta mappningen som skapas automatiskt mellan $/projects/project_one och C:\projects\project_one:
tf workfold $/projects/project_one C:\DifferentWorkfold
Mappningar under kappor
Mappningar av oklädda mappar som finns under en dold mapp i hierarkin för versionskontroll kan mappas till din lokala arbetsyta.
Exempel
I följande exempel visas mappningarna för arbetsytan som c:\projects finns i:
c:\projects>tf workfold
I följande exempel döljs mappen c:\projects\lib :
c:\projects>tf workfold /cloak c:\projects\lib
I följande exempel visas mappningen för den lokala filen word.cs:
c:\projects>tf workfold word.cs
I följande exempel mappas mappen C:\DifferentWorkfold till Azure DevOps-servermappen $/projects/project_one och ersätter den tidigare arbetsytemappningen för servermappen $/projects/project_one Azure DevOps:
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold