Kommandot Workspace (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) workspace ger dig ett sätt att skapa, ta bort, visa eller ändra egenskaper och mappningar som är associerade med en arbetsyta.
Förutsättningar
- Om du vill ändra eller ta bort en befintlig arbetsyta är du ägare eller har den globala Administrera arbetsytor behörighet inställd på Tillåt.
- Om du vill skapa en arbetsyta måste du ha den globala Skapa en arbetsyta behörighet inställd på Tillåt.
- Om du vill skapa arbetsytor för andra användare har du Administrera arbetsytor behörighet inställd på Tillåt.
Mer information finns i TFVC-standardbehörigheter.
Syntax
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)]
Parametrar
I följande avsnitt beskrivs argument och alternativ för kommandot workspace.
Argument
| Argument | Beskrivning |
|---|---|
<workspace-name> |
Anger ett namn på den arbetsyta som du vill skapa, redigera, ta bort eller visa information om. |
<workspace-owner> |
Anger ett användarnamn för arbetsytan. Den här parametern krävs när arbetsytans ägare inte är den person som utför kommandot. |
<computer-name> |
Ger ett värde till alternativet /computer. |
<comment> |
Ger ett värde till alternativet /comment. |
@<comment-file> |
Anger sökvägen till en fil där kommentaren ska läsas. |
<username> |
Ger ett värde till alternativet /login. Du kan ange det här värdet som antingen DOMAIN\<username> eller <username>. |
<password> |
Ger ett värde till alternativet /login. |
<team-project-collection-url> |
URL:en för projektsamlingen som innehåller arbetsytan som du vill skapa, redigera, ta bort eller visa information om, till exempel https://myserver:8080/tfs/DefaultCollection. |
<owner-name> |
Ger ett värde till alternativet /newowner. |
Alternativ
| Alternativ | Beskrivning |
|---|---|
/new |
Skapar en ny arbetsyta. |
/template |
Anger en befintlig arbetsyta som ska användas som mall för att skapa en ny arbetsyta. Den nya arbetsytan använder mappningarna för den befintliga arbetsytan. |
/delete |
Tar bort den angivna arbetsytan. |
/computer |
Anger namnet på den dator där en arbetsyta ska skapas. Det här alternativet är ett avancerat alternativ. |
/comment |
Innehåller en kommentar som beskriver arbetsytan. |
/newname |
Byter namn på en befintlig arbetsyta. |
/noprompt |
Utför det angivna kommandot för arbetsytan utan att visa en dialogruta. |
/collection |
Anger projektsamlingen. |
/permission |
Anger alternativen för arbetsytebehörigheter:
Private: Endast ägarna kan använda, checka in filer till eller administrera arbetsytan.
- Public Limited: Alla giltiga användare kan använda arbetsytan. Men bara ägarna kan checka in filer till eller administrera arbetsytan.
- Public: Alla giltiga användare kan använda, checka in filer till eller administrera arbetsytan. |
/location |
Anger var arbetsytan skapas:
local: På klientdatorn. Det här värdet är standardvärdet.
- server: På Azure DevOps-servern. |
/login |
Anger användarnamn och lösenord för att autentisera användaren med Azure DevOps. |
/newowner |
Anger användarnamnet för arbetsytans nya ägare. |
Anmärkningar
En arbetsyta är en lokal kopia av filerna och mapparna på servern, plus eventuella ändringar som du har gjort lokalt. När du lägger till, redigerar, tar bort, flyttar, byter namn på eller på annat sätt ändrar ett versionsstyrt objekt isoleras ändringarna på arbetsytan, där du kan göra och testa ändringarna. När du checka in ditt arbete på teamets kodbascheckar du in ändringarna på servern. De blir tillgängliga för andra användare som befinner sig utanför din arbetsyta.
Mer information om hur du använder kommandoradsverktyget tf finns i Använda Team Foundation-versionskontrollkommandon.
Skapa en arbetsyta
Innan du kan lägga till filer till versionskontrollservern eller checka ut objekt på servern måste du skapa en arbetsyta eller associera en befintlig med den aktuella katalogen. Mer information finns i Konfigurera Versionskontroll för Team Foundation på utvecklingsdatorn.
Följ dessa steg för att göra den aktuella katalogen till en arbetsmapp för en befintlig arbetsyta på datorn:
- Ange
tf workspace <workspace-name>, där<workspace-name>är namnet på den befintliga arbetsytan. Dialogrutan Redigera arbetsyta visas. - Välj klicka här för att ange en ny arbetsmapp.
- I rutan Källkontrollmapp anger du den serversökväg som du vill mappa den aktuella katalogen till.
- I rutan lokal mapp anger du den aktuella katalogen.
- Välj OK.
När du skapar en ny arbetsyta kan du ange en mallarbetsyta som en del av alternativet /new. När du anger en mallarbetsyta skapar TFVC en ny arbetsyta på den aktuella datorn. TFVC anger också ägaren till den aktuella ägaren och replikerar följande egenskaper för arbetsytan till den nya arbetsytan från mallarbetsytan: mappings och comment. Om inget namn anges använder systemet ett namn som baseras på det aktuella datornamnet. När du skapar en arbetsyta med hjälp av en mall hämtar TFVC inte de filer som den mappar till från servern. Använd kommandot get för att synkronisera den nya arbetsytan med den senaste versionen på servern. Mer information finns i Hämta kommando.
Mappning med en mapp
Du kan välja att endast mappa de omedelbara underordnade objekten i en versionskontrollmapp till en lokal arbetsyta. Det gör du genom att lägga till ett asterisktecken (*) jokertecken i rutan Source Control Folder i dialogrutan Lägg till arbetsyta, till exempel $/folder/*. I annat fall mappas alla underordnade objekt i mappen versionskontroll rekursivt till den lokala arbetsytan.
Mappmappning i en versionskontrollhierarki är användbar eftersom den begränsar antalet objekt som laddas ned till klientdatorn. Ett annat sätt att begränsa nedladdade filer är att dölja filer som du inte behöver ha på din arbetsyta. Mer information finns i Optimera din arbetsyta. Den här metoden ger snabbare nedladdningstider och sparar diskutrymme på klientdatorn.
Ta bort en arbetsyta
Om du tar bort en arbetsyta som innehåller väntande ändringar avbryter TFVC de väntande ändringarna som en del av borttagningsprocessen. Om du tar bort en arbetsyta tas inte filerna och mapparna bort på klientdatorn som fanns på arbetsytan.
Not
Kommandon som körs manuellt kräver /noprompt alternativet för att kringgå användarens bekräftelse. Var försiktig om du använder PowerShell Start()-metoden för att köra kommandon. Alternativet /noprompt kan anges automatiskt i PowerShell.
När du tar bort en arbetsyta måste du ange <workspace-owner> och <workspace-name>
Du kan använda kommandot workspace för att hämta dessa värden. Mer information finns i kommandot workspaces.
Kör följande kommando för att hitta värdet <workspace-owner>:
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
Om du vill hitta <workspace-name>-värdet använder du värdet <OwnerId> från föregående kommandos utdata som <workspace-owner> värde. Det värdet har formatet för ett Azure Active Directory-objekt-ID (Azure AD) följt av ett omvänt snedstreck och ett användarnamn för användarens huvudnamn. Använd hela värdet. Kör sedan följande kommando:
c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`
Kör följande kommando för att ta bort arbetsytan:
c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`
Redigera en arbetsyta
Du kan ändra följande arbetsyteattribut:
- Namn på arbetsyta
- Kommentar
- Mappning av arbetsmappar
Om ingen arbetsytespecifikation anges används arbetsytan för den aktuella mappen.
Exempel
I följande exempel öppnas dialogrutan Lägg till arbetsyta och skapar en ny arbetsyta. Du kan använda dialogrutan Lägg till arbetsyta för att redigera källkontrollmappen, ägaren, datorn, kommentaren och de lokala mapparna.
c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection
I följande exempel skapas en ny arbetsyta med namnet Beta1 och tilldelar jenh- som arbetsyteägare. Ha AdminWorkspaces behörighet att tilldela ägarskap för en ny arbetsyta till en annan användare. Mer information om säkerhetsbehörigheter finns i TFVC-standardbehörigheter.
c:\projects>tf workspace /new Beta1;jenh
I följande exempel skapas en ny arbetsyta med hjälp av arbetsytan Beta1 som ägs av jenh- som en mall:
c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection
Följande exempel tar bort Beta1--arbetsytan från servern:
c:\projects>tf workspace /delete Beta1
I följande exempel redigeras egenskaper för den aktuella arbetsytan:
c:\projects>tf workspace
I följande exempel öppnas Beta1 arbetsyta som ägs av jenh- så att du kan se dess egenskaper och mappningar. Om du har behörigheten AdminWorkspaces kan du ändra egenskaper och mappningar för arbetsytan.
c:\projects> tf workspaces Beta1;jenh