Byt namn på kommandot (Versionskontroll för Team Foundation)

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Kommandot Team Foundation Version Control (TFVC) rename ändrar namnet eller sökvägen till en fil eller mapp. Du kan använda rename kommandot, aliasen move eller ren, för att flytta en fil eller mapp till en ny plats.

Kommentar

Resultatet av det här kommandot återspeglas inte på servern förrän du checkar in. Mer information finns i Utveckla kod och hantera väntande ändringar.

Förutsättningar

Om du vill använda rename kommandot måste du ha behörigheten Checka ut till Tillåt. Mer information finns i TFVC-standardbehörigheter.

Syntax

tf rename [/lock:(none|checkout|checkin)] [/login:username,[password]] olditem newitem

Parametrar

Argument

Argument

Beskrivning

<olditem>

Det ursprungliga namnet och sökvägen till den fil eller mapp som ska byta namn. Du kan ange en sökväg till en lokal arbetsyta, till exempel C:\myfiles\314.cs eller en TFVC-serversökväg som $/myfiles/314.cs.

<newitem>

Det nya namnet på filen eller mappen. Du kan använda detta för att ange en annan plats för lokal eller TFVC-serversökväg.

<username>

Ger alternativet ett värde /login . Du kan ange ett användarnamnsvärde som antingen DOMAIN\username eller username.

Alternativ

Alternativ

Beskrivning

/lock

Inkludera det här alternativet för att förhindra att andra användare checkar in eller checkar ut de angivna objekten. Om det här alternativet inte har angetts ändras inte objektets befintliga låsstatus. Mer information finns i Förstå låstyper.

Låsalternativ:

  • None: Inget lås tillämpas.
  • Checkin: Andra användare kan checka ut de angivna objekten, men de kan inte checka in revisioner av låsta filer förrän du släpper låset genom att göra en incheckning. Om några andra användare har låst något av de angivna objekten misslyckas låsåtgärden.
  • Checkout: Hindrar andra användare från att checka in eller checka ut något av de angivna objekten tills du släpper låset genom att göra en incheckning. Om några andra användare har låst något av de angivna objekten misslyckas låsåtgärden.

/login

Anger användarnamn och lösenord för att autentisera användaren med Azure DevOps.

Kommentarer

Du kan använda rename kommandot för tf kommandoradsverktyget för att flytta eller byta namn på ett versionsstyrt objekt på arbetsytan. rename Använd kommandot för att flytta flera filer genom att ange jokertecken. Möjligheten att byta namn på flera versionskontrollerade filer eller mappar är endast tillgänglig från kommandoraden.

rename Använd kommandot för att utföra följande åtgärder:

  • Byt namn på olditem till , till newitemexempel tf rename 314.cs 315.cs.
  • olditem Flytta till en ny plats på TFVC-servern genom att ange en newitem vars sökväg skiljer sig från sökvägen för olditem, till exempel tf rename 314.cs ..\newdir\314.cs.

Om du anger en newitem som anger en obefintlig mapp rename skapar kommandot målmappen. Om newitem är en mapp olditem , blir ett underordnat newitemtill .

Du kan inte byta namn på ett objekt om:

  • Du har redan tagit bort den innan den checkades in på samma arbetsyta.
  • Det nya namnet finns redan på TFVC-servern och är inte en mapp.
  • Du har redan lagt till, förgrenat eller bytt namn på den väntande incheckningen av objektet.
  • Objektet mappas på arbetsytan men är inte tillgängligt på den lokala disken.
  • Objektet är dolt.

Du kan byta namn på ett objekt där en annan fil med samma namn har lagts till i väntan på incheckning, men du kan inte byta namn på ett objekt som har förgrenats men ännu inte checkats in. När du byter namn på en fil som har väntande redigeringar bevaras redigeringarna.

Ett objekt som uttryckligen mappas kan inte byta namn utan att först ändra mappningen. Om det till exempel finns en mappmappning av $/ProjectX/MyApp till c:\MyApp kan du inte byta namn på MyApp. Du kan byta namn på objekt under MyApp, men inte själva MyApp .

Mer information om hur du använder tf kommandoradsverktyget finns i Använda Team Foundation-versionskontrollkommandon.

Exempel

I följande exempel ändras namnet på 314.cs till 1254.cs.

c:\projects>tf rename  314.cs  1254.cs

I följande exempel byter du namn på 314.cs till 1254.cs och flyttar den till mappen newdir .

c:\projects>tf rename 314.cs ..\newdir\1254.cs

I följande exempel ändras namnet på Form1.vb till MainPage.vb och ett lås tillämpas på det.

c:\projects>tf rename Form1.vb MainPage.vb /lock:checkin