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.
Voorwaarden
- Als u een bestaande werkruimte wilt wijzigen of verwijderen, moet u de eigenaar zijn of de globale Werkruimten beheren machtigingen ingesteld op Toestaan.
- Als u een werkruimte wilt maken, moet u beschikken over de globale Een werkruimte maken machtigingen hebt ingesteld op Toestaan.
- Als u werkruimten wilt maken voor andere gebruikers, moet u de Werkruimten beheren machtigingen ingesteld op Toestaan.
Zie standaard TFVC-machtigingenvoor 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 opdracht workspace 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 optie /computer. |
<comment> |
Biedt een waarde voor de optie /comment. |
@<comment-file> |
Hiermee geeft u het pad van een bestand waarin de opmerking moet worden gelezen. |
<username> |
Biedt een waarde voor de optie /login. U kunt deze waarde opgeven als DOMAIN\<username> of <username>. |
<password> |
Biedt een waarde voor de optie /login. |
<team-project-collection-url> |
De URL van de projectverzameling die de werkruimte bevat die u wilt maken, bewerken, verwijderen of informatie weergeven over bijvoorbeeld https://myserver:8080/tfs/DefaultCollection. |
<owner-name> |
Biedt een waarde voor de optie /newowner. |
Opties
| Optie | Beschrijving |
|---|---|
/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 bestanden gebruiken, inchecken of de werkruimte beheren. |
/location |
Hiermee geeft u op waar de werkruimte wordt gemaakt:
local: op de clientcomputer. Deze waarde 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 controleert 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 Opdrachten voor versiebeheer van Team Foundation gebruikenvoor meer informatie over het gebruik van het opdrachtregelprogramma tf.
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 ontwikkelcomputervoor 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>in, waarbij<workspace-name>de naam van de bestaande werkruimte is. Het dialoogvenster Werkruimte bewerken wordt weergegeven. - Selecteer 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 optie /new. 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 opdracht get om de nieuwe werkruimte te synchroniseren met de nieuwste versie op de server. Zie Opdracht ophalenvoor 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 optimaliserenvoor 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 /noprompt vereist om bevestiging van gebruikers te omzeilen. Wees voorzichtig als u de PowerShell-methode Start() gebruikt om opdrachten uit te voeren. De optie /noprompt kan automatisch worden ingesteld in PowerShell.
Wanneer u een werkruimte verwijdert, moet u de <workspace-owner> en <workspace-name> opgeven
U kunt de opdracht workspace gebruiken om deze waarden op te halen. Zie de opdracht werkruimtenvoor 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 vinden, 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
- Commentaar
- 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 gemaakt met de naam Beta1 en wordt jenh- toegewezen als eigenaar van de werkruimte. Zorg ervoor dat de AdminWorkspaces machtiging hebben om het eigendom van een nieuwe werkruimte toe te wijzen aan een andere gebruiker. Zie Standaard TFVC-machtigingenvoor 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 Beta1 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 kunt zien. Als u de machtiging AdminWorkspaces hebt, kunt u de eigenschappen en toewijzingen van de werkruimte wijzigen.
c:\projects> tf workspaces Beta1;jenh