Werkruimteopdracht (Team Foundation-versiebeheer)
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Met de opdracht Team Foundation Version Control (TFVC) workspace kunt u eigenschappen en toewijzingen maken, verwijderen, weergeven of wijzigen die zijn gekoppeld aan een werkruimte.
Vereisten
- Als u een bestaande werkruimte wilt wijzigen of verwijderen, moet u de eigenaar zijn of de machtigingen voor globale Beheer ister-werkruimten hebben ingesteld op Toestaan.
- Als u een werkruimte wilt maken, moet u beschikken over de algemene machtiging Een werkruimte maken op Toestaan.
- Als u werkruimten wilt maken voor andere gebruikers, moet de machtiging Beheer ister werkruimten zijn ingesteld op Toestaan.
Zie Standaard TFVC-machtigingen voor meer informatie.
Syntaxis
tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]
tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]
tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]
Parameters
In de volgende secties worden argumenten en opties van de workspace opdracht beschreven.
Argumenten
| Argument | Beschrijving |
|---|---|
<workspace-name> |
Hiermee geeft u een naam op voor de werkruimte waarover u informatie wilt maken, bewerken, verwijderen of weergeven. |
<workspace-owner> |
Hiermee geeft u een gebruikersnaam voor de werkruimte. Deze parameter is vereist wanneer de eigenaar van de werkruimte niet de persoon is die de opdracht uitvoert. |
<computer-name> |
Biedt een waarde voor de /computer optie. |
<comment> |
Biedt een waarde voor de /comment optie. |
@<comment-file> |
Hiermee geeft u het pad van een bestand waarin de opmerking moet worden gelezen. |
<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. |
<team-project-collection-url> |
De URL van de projectverzameling met de werkruimte die u wilt maken, bewerken, verwijderen of weergeven, bijvoorbeeld https://myserver:8080/tfs/DefaultCollection. |
<owner-name> |
Biedt een waarde voor de /newowner optie. |
Opties
| Optie | Omschrijving |
|---|---|
/new |
Hiermee maakt u een nieuwe werkruimte. |
/template |
Hiermee geeft u een bestaande werkruimte op die moet worden gebruikt als sjabloon voor het maken van een nieuwe werkruimte. De nieuwe werkruimte maakt gebruik van de toewijzingen van de bestaande werkruimte. |
/delete |
Hiermee verwijdert u de opgegeven werkruimte. |
/computer |
Hiermee geeft u de naam op van de computer waarop een werkruimte moet worden gemaakt. Deze optie is een geavanceerde optie. |
/comment |
Geeft een opmerking waarin de werkruimte wordt beschreven. |
/newname |
Hiermee wijzigt u de naam van een bestaande werkruimte. |
/noprompt |
Voert de opgegeven werkruimteopdracht uit zonder een dialoogvenster weer te geven. |
/collection |
Hiermee geeft u de projectverzameling op. |
/permission |
Hiermee geeft u de opties voor werkruimtemachtigingen op:
Private: Alleen de eigenaren kunnen de werkruimte gebruiken, bestanden inchecken of beheren.- Public Limited: Elke geldige gebruiker kan de werkruimte gebruiken. Maar alleen de eigenaren kunnen bestanden inchecken of beheren in de werkruimte.- Public: elke geldige gebruiker kan de werkruimte gebruiken, inchecken of beheren. |
/location |
Hiermee geeft u op waar de werkruimte wordt gemaakt:
local: Op de clientcomputer. Dit is de standaardwaarde.- server: op de Azure DevOps-server. |
/login |
Hiermee geeft u de gebruikersnaam en het wachtwoord op om de gebruiker te verifiëren met Azure DevOps. |
/newowner |
Hiermee geeft u de gebruikersnaam op voor de nieuwe eigenaar van de werkruimte. |
Opmerkingen
Een werkruimte is een lokale kopie van de bestanden en mappen op de server, plus eventuele wijzigingen die u lokaal hebt aangebracht. Wanneer u een door versie beheerd item toevoegt, bewerkt, verwijdert, verplaatst, wijzigt of anderszins wijzigt, worden uw wijzigingen geïsoleerd in uw werkruimte, waar u uw wijzigingen kunt aanbrengen en testen. Wanneer u uw werk incheckt op de codebasis van het team, voert u uw wijzigingen door op de server. Ze worden beschikbaar voor andere gebruikers die zich buiten uw werkruimte bevinden.
Zie Team Foundation-versiebeheeropdrachten gebruiken voor meer informatie over het gebruik van het tf opdrachtregelprogramma.
Een werkruimte maken
Voordat u bestanden aan de versiebeheerserver kunt toevoegen of items op de server kunt uitchecken, moet u een werkruimte maken of een bestaande aan de huidige map koppelen. Zie Team Foundation-versiebeheer instellen op uw ontwikkelcomputer voor meer informatie.
Als u de huidige map een werkmap wilt maken voor een bestaande werkruimte op uw computer, voert u de volgende stappen uit:
- Voer
tf workspace <workspace-name>de<workspace-name>naam in van de bestaande werkruimte. Het dialoogvenster Werkruimte bewerken wordt weergegeven. - Klik hier om een nieuwe werkmap in te voeren.
- Voer in het vak Bronbeheermap het serverpad in waarnaar u de huidige map wilt toewijzen.
- Voer in het vak Lokale map de huidige map in.
- Selecteer OK.
Wanneer u een nieuwe werkruimte maakt, kunt u een sjabloonwerkruimte opgeven als onderdeel van de /new optie. Wanneer u een sjabloonwerkruimte opgeeft, maakt TFVC een nieuwe werkruimte op de huidige computer. TFVC stelt de eigenaar ook in op de huidige eigenaar en repliceert de volgende werkruimte-eigenschappen naar de nieuwe werkruimte vanuit de sjabloonwerkruimte: mappings en comment. Als er geen naam is opgegeven, gebruikt het systeem een naam die is gebaseerd op de huidige computernaam. Wanneer u een werkruimte maakt met behulp van een sjabloon, haalt TFVC niet de bestanden op waarnaar deze is toegewezen van de server. Gebruik de get opdracht om de nieuwe werkruimte te synchroniseren met de nieuwste versie op de server. Zie De opdracht Ophalen voor meer informatie.
Toewijzing van één map
U kunt ervoor kiezen om alleen de directe onderliggende items van een map met versiebeheer toe te wijzen aan een lokale werkruimte. U doet dit door een jokerteken (*) toe te voegen in het vak Bronbeheermap in het dialoogvenster Werkruimte toevoegen, bijvoorbeeld $/folder/*. Anders worden standaard alle onderliggende items van de map versiebeheer recursief toegewezen aan de lokale werkruimte.
Toewijzing van één map binnen een versiebeheerhiërarchie is handig omdat hiermee het aantal items dat naar de clientcomputer wordt gedownload, wordt beperkt. Een andere manier om gedownloade bestanden te beperken, is door bestanden te verbergen die u niet in uw werkruimte hoeft te hebben. Zie Uw werkruimte optimaliseren voor meer informatie. Deze aanpak biedt snellere downloadtijden en bespaart schijfruimte op de clientcomputer.
Een werkruimte verwijderen
Als u een werkruimte verwijdert die wijzigingen in behandeling bevat, annuleert TFVC de wijzigingen die in behandeling zijn als onderdeel van het verwijderingsproces. Als u een werkruimte verwijdert, worden de bestanden en mappen op de clientcomputer die zich in die werkruimte bevonden, niet verwijderd.
Notitie
Voor opdrachten die handmatig worden uitgevoerd, is de optie vereist /noprompt om gebruikersbevestiging te omzeilen. Wees voorzichtig als u de PowerShell-methode Start() gebruikt om opdrachten uit te voeren. De /noprompt optie kan automatisch worden ingesteld in PowerShell.
Bij het verwijderen van een werkruimte moet u de <workspace-owner> en <workspace-name>
U kunt de workspace opdracht gebruiken om deze waarden op te halen. Zie de opdracht Werkruimten voor meer informatie.
Voer de volgende opdracht uit om de <workspace-owner> waarde te vinden:
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
Als u de <workspace-name> waarde wilt zoeken, gebruikt u de <OwnerId> waarde uit de uitvoer van de vorige opdracht als de <workspace-owner> waarde. Deze waarde heeft de indeling van een Azure AD-object-id (Azure Active Directory), gevolgd door een backslash en een user principal name. Gebruik de volledige waarde. Voer vervolgens de volgende opdracht uit:
c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`
Voer de volgende opdracht uit om de werkruimte te verwijderen:
c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`
Een werkruimte bewerken
U kunt de volgende werkruimtekenmerken wijzigen:
- Werkruimtenaam
- Opmerking
- Toewijzingen van werkmappen
Als er geen werkruimtespecificatie is opgegeven, wordt de werkruimte voor de huidige map gebruikt.
Voorbeelden
In het volgende voorbeeld wordt het dialoogvenster Werkruimte toevoegen geopend en wordt een nieuwe werkruimte gemaakt. U kunt het dialoogvenster Werkruimte toevoegen gebruiken om de bronbeheermap, eigenaar, computer, opmerking en lokale mappen te bewerken.
c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection
In het volgende voorbeeld wordt een nieuwe werkruimte met de naam Beta1 gemaakt en wordt jenh toegewezen als eigenaar van de werkruimte. U moet over de machtiging Beheer Werkruimten beschikken om het eigendom van een nieuwe werkruimte aan een andere gebruiker toe te wijzen. Zie Standaard TFVC-machtigingen voor meer informatie over beveiligingsmachtigingen.
c:\projects>tf workspace /new Beta1;jenh
In het volgende voorbeeld wordt een nieuwe werkruimte gemaakt met behulp van de Beta1-werkruimte die eigendom is van jenh als sjabloon:
c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection
In het volgende voorbeeld wordt de Bèta1-werkruimte van de server verwijderd:
c:\projects>tf workspace /delete Beta1
In het volgende voorbeeld worden eigenschappen voor de huidige werkruimte bewerkt:
c:\projects>tf workspace
In het volgende voorbeeld wordt de Beta1-werkruimte geopend die eigendom is van jenh , zodat u de eigenschappen en toewijzingen ervan kunt zien. Als u de machtiging Beheer Werkruimten hebt, kunt u de eigenschappen en toewijzingen van de werkruimte wijzigen.
c:\projects> tf workspaces Beta1;jenh