Kommandot Workspace (Versionskontroll för Team Foundation)
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Visual Studio 2019 | Visual Studio 2022
Med kommandot Team Foundation Version Control (TFVC) workspace kan du 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 måste du vara ägare eller ha den globala behörigheten Administrera arbetsytor inställd på Tillåt.
- Om du vill skapa en arbetsyta måste du ha den globala behörigheten Skapa en arbetsyta inställd på Tillåt.
- Om du vill skapa arbetsytor för andra användare måste du ha behörigheten Administrera arbetsytor 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 workspace kommandot.
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 alternativet ett värde /computer . |
<comment> |
Ger alternativet ett värde /comment . |
@<comment-file> |
Anger sökvägen till en fil där kommentaren ska läsas. |
<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 . |
<team-project-collection-url> |
URL:en för projektsamlingen som innehåller den arbetsyta som du vill skapa, redigera, ta bort eller visa information om, till exempel https://myserver:8080/tfs/DefaultCollection. |
<owner-name> |
Ger alternativet ett värde /newowner . |
Alternativ
| Alternativ | Description |
|---|---|
/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 ä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. |
Kommentarer
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 checkar in ditt arbete till teamets kodbas checkar 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 tf kommandoradsverktyget 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 om du vill 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. get Använd kommandot 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 Källkontrollmapp i dialogrutan Lägg till arbetsyta , $/folder/*till exempel . 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.
Kommentar
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-metoden Start() för att köra kommandon. Alternativet /noprompt kan anges automatiskt i PowerShell.
När du tar bort en arbetsyta måste du ange och <workspace-owner><workspace-name>
Du kan använda workspace kommandot för att hämta dessa värden. Mer information finns i kommandot arbetsytor.
Kör följande kommando för att hitta <workspace-owner> värdet:
c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml
Om du vill hitta värdet <workspace-name> använder du <OwnerId> värdet 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 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 jenh tilldelas som arbetsyteägare. Du måste ha behörigheten AdminWorkspaces för 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 beta1-arbetsytan 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 den 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