Opdracht Werkmap (Team Foundation Version Control)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
De opdracht Team Foundation Version Control (TFVC) workfold maakt, wijzigt of geeft informatie weer over de toewijzingen tussen uw werkruimtemappen en de mappen die zich op de Azure DevOps-server voor TFVC bevinden.
Vereisten
Als u de workfold opdracht wilt gebruiken, moet u de eigenaar van de opgegeven of impliciete werkruimte zijn of de globale machtiging Werkruimten beheren hebben ingesteld op Toestaan. Zie Standaard TFVC-machtigingen voor meer informatie.
Syntaxis
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>]]
Parameters
In de volgende secties worden argumenten en opties van de workfold opdracht beschreven.
Argumenten
Argument
Beschrijving
<workspace-name>
Hiermee geeft u de naam op van de werkruimte waarop de opdracht werkt met de /workspace optie.
<server-folder>
Hiermee geeft u de naam van een Azure DevOps-servermap.
<local-folder>
Hiermee geeft u de naam van een lokale map.
<team-project-collection-url>
De URL van de projectverzameling die de mappen bevat die u wilt vergelijken met servermappen, bijvoorbeeld https://myserver:8080/tfs/DefaultCollection/.
<username>
Biedt een waarde voor de /login optie. U kunt deze waarde opgeven als of DOMAIN\<username> <username>.
<password>
Biedt een waarde voor de /login optie.
Opties
Optie
Beschrijving
/workspace
Hiermee geeft u de naam op van de werkruimte waarin moet worden gewerkt.
/map
Hiermee geeft u een koppeling op tussen een lokale map en de Azure DevOps-servermap. Standaard gebruikt de workfold opdracht deze optie, zelfs als deze niet is opgegeven, tenzij /unmap, /cloakof /decloak is opgegeven.
/unmap
Hiermee geeft u op welke maptoewijzing uit de werkruimte moet worden verwijderd.
/cloak
Hiermee geeft u op dat de map moet worden uitgesloten van alle acties voor versiebeheer die in de werkruimte worden gemaakt.
/decloak
Sluit een map af, zodat de map kan worden opgehaald in de werkruimte.
/collection
Hiermee geeft u de projectverzameling op.
/login
Hiermee geeft u de gebruikersnaam en het wachtwoord op om de gebruiker te verifiëren met Azure DevOps.
Opmerkingen
U kunt de workfold opdracht van het tf opdrachtregelprogramma gebruiken om werkruimtetoewijzingen te maken en te bewerken. Een werkruimtetoewijzing maakt een map aan de clientzijde waarin alle bestanden en submappen in de Azure DevOps-servermap worden opgehaald wanneer u een tf get bewerking uitvoert. De get bewerking werkt niet als de map aan de clientzijde wordt gekmanteld.
U kunt ook een sterretje (*) gebruiken om een Azure DevOps Server-map en de directe items toe te wijzen aan uw lokale werkruimte. Deze toewijzing wordt vaak aangeduid als één maptoewijzing.
Zie Team Foundation-versiebeheeropdrachten gebruiken voor meer informatie over het gebruik van het tf opdrachtregelprogramma.
Opties voor werkruimtetoewijzing
Een werkruimtetoewijzing is een lijst met actieve en gekmantelde items. U kunt Azure DevOps-serveritems toevoegen aan de toegewezen lijst in de werkruimte met behulp van de /map optie. U kunt een item ook expliciet uitsluiten van de werkruimte met behulp van de /cloak optie. U kunt alleen items met een toegewezen bovenliggende map klonen. Cloaking is een effectieve manier om de snelheid van batchbewerkingen get te verbeteren en ruimte op schijf te besparen.
Gebruik cloaking met discretie. Als u compilatie- en integratieproblemen wilt voorkomen, moet u alleen die items die u kent buiten het bereik van uw huidige en toekomstige projecten, zoals afbeeldingen en externe documentatiebestanden, klonen.
U kunt de /unmap en /decloak opties gebruiken om toegewezen en gemantelde vermeldingen selectief te verwijderen uit de toewijzing van de werkruimte.
Hoe werkruimtetoewijzingen worden toegepast
Werkruimtetoewijzingen worden standaard recursief toegepast. Wanneer u een lokale map toe wijst aan een Azure DevOps-servermap, maakt het systeem impliciet een toewijzing tussen alle huidige en toekomstige submappen.
Stel dat u $/projecten toe wijst aan C:\projects. Vervolgens voegt u een project met de naam $/projects/project_one toe en voert u vervolgens de get opdracht uit in de werkruimte. In dit scenario maakt TFVC automatisch een lokale werkmap met de naam project_one in de map C:\projects.
In het volgende voorbeeld wordt een jokerteken (*) gebruikt om een servermap en de directe items toe te wijzen aan uw lokale werkruimte:
tf workfold $/projects/MyTeamProject/* C:\MyLocalWorkfold\MyTeamProject
In het volgende voorbeeld wordt de workfold opdracht gebruikt om de toewijzing te overschrijven die automatisch wordt gemaakt tussen $/projects/project_one en C:\projects\project_one:
tf workfold $/projects/project_one C:\DifferentWorkfold
Toewijzingen onder cloaks
Toewijzingen van niet-afgeschermde mappen die zich onder een gemantelde map in de versiebeheerhiërarchie bevinden, kunnen worden toegewezen aan uw lokale werkruimte.
Voorbeelden
In het volgende voorbeeld worden de toewijzingen weergegeven voor de werkruimte waarin c:\projects zich bevinden:
c:\projects>tf workfold
In het volgende voorbeeld wordt de map c:\projects\lib weergegeven:
c:\projects>tf workfold /cloak c:\projects\lib
In het volgende voorbeeld ziet u de toewijzing voor het lokale bestand word.cs:
c:\projects>tf workfold word.cs
In het volgende voorbeeld wordt de map C:\DifferentWorkfold toegewezen aan de Azure DevOps-servermap $/projects/project_one en vervangt u de vorige werkruimtetoewijzing voor de map $/projects/project_one Azure DevOps-server:
c:\projects>tf workfold $/projects/project_one C:\DifferentWorkfold