Delen via

Opdracht Naam wijzigen (Team Foundation Version Control)

  • Artikel

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) rename wordt de naam of het pad van een bestand of map gewijzigd. U kunt de rename opdracht, of de aliassen move of ren, gebruiken om een bestand of map naar een nieuwe locatie te verplaatsen.

Notitie

De resultaten van deze opdracht worden pas weergegeven op de server als u een check-in uitvoert. Zie Code ontwikkelen en wachtende wijzigingen beheren voor meer informatie.

Vereisten

Als u de rename opdracht wilt gebruiken, moet de machtiging Uitchecken zijn ingesteld op Toestaan. Zie Standaard TFVC-machtigingen voor meer informatie.

Syntaxis

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

Parameters

Argumenten

Argument

Beschrijving

<olditem>

De oorspronkelijke naam en het pad van het bestand of de map waarvan de naam moet worden gewijzigd. U kunt een lokaal werkruimtepad opgeven, zoals C:\myfiles\314.cs of een TFVC-serverpad, zoals $/myfiles/314.cs.

<newitem>

De nieuwe naam van het bestand of de map. U kunt dit gebruiken om een andere lokale locatie of een TFVC-serverpadlocatie op te geven.

<username>

Biedt een waarde voor de /login optie. U kunt een gebruikersnaamwaarde opgeven als of DOMAIN\username username.

Opties

Optie

Beschrijving

/lock

Neem deze optie op om te voorkomen dat andere gebruikers de opgegeven items inchecken of uitchecken. Als deze optie niet is opgegeven, wordt de bestaande vergrendelingsstatus van het item niet gewijzigd. Zie Vergrendelingstypen begrijpen voor meer informatie.

Vergrendelingsopties:

  • None: Er wordt geen vergrendeling toegepast.
  • Checkin: Andere gebruikers kunnen de opgegeven items uitchecken, maar ze kunnen geen revisies inchecken voor vergrendelde bestanden totdat u de vergrendeling loslaat door een check-in uit te voeren. Als andere gebruikers een van de opgegeven items hebben vergrendeld, mislukt de vergrendelingsbewerking.
  • Checkout: Hiermee voorkomt u dat andere gebruikers een van de opgegeven items inchecken of uitchecken totdat u de vergrendeling loslaat door een incheckbewerking uit te voeren. Als andere gebruikers een van de opgegeven items hebben vergrendeld, mislukt de vergrendelingsbewerking.

/login

Hiermee geeft u de gebruikersnaam en het wachtwoord op om de gebruiker te verifiëren met Azure DevOps.

Opmerkingen

U kunt de rename opdracht van het tf opdrachtregelprogramma gebruiken om een door versie beheerd item in uw werkruimte te verplaatsen of de naam ervan te wijzigen. Gebruik de rename opdracht om meerdere bestanden te verplaatsen door jokertekens op te geven. De mogelijkheid om de naam van meerdere versiebeheerde bestanden of mappen te wijzigen, is alleen beschikbaar vanaf de opdrachtregel.

Gebruik de rename opdracht om de volgende acties uit te voeren:

  • Wijzig de naam van de olditem naam in de newitem, zoals tf rename 314.cs 315.cs.
  • Verplaats de olditem naar een nieuwe locatie op de TFVC-server door een newitem wiens pad verschilt van die van de olditem, zoals tf rename 314.cs ..\newdir\314.cs.

Als u een newitem map opgeeft waarmee een niet-bestaande map wordt opgegeven, wordt met de rename opdracht de doelmap gemaakt. Als newitem het een map is, olditem wordt het een onderliggend element van newitem.

U kunt de naam van een item niet wijzigen als:

  • U hebt het al verwijderd voordat deze is ingecheckt in dezelfde werkruimte.
  • De nieuwe naam bestaat al op de TFVC-server en is geen map.
  • U hebt het item al toegevoegd, vertakt of de naam ervan gewijzigd in behandeling.
  • Het item is toegewezen in de werkruimte, maar niet beschikbaar op de lokale schijf.
  • Het item wordt gekmanteld.

U kunt de naam van een item wijzigen waarvoor een ander bestand met dezelfde naam is toegevoegd in afwachting van inchecken, maar u kunt de naam van een item dat is vertakt, niet wijzigen, maar nog niet is ingecheckt. Wanneer u de naam van een bestand wijzigt dat bewerkingen in behandeling heeft, blijven de bewerkingen behouden.

De naam van een item dat expliciet is toegewezen, kan niet worden gewijzigd zonder eerst de toewijzing te wijzigen. Als er bijvoorbeeld een werkmaptoewijzing is van $/ProjectX/MyApp naar c:\MyApp, kunt u de naam van Mijnapp niet wijzigen. U kunt de naam van items wijzigen onder MijnApp, maar niet MijnApp zelf.

Zie Team Foundation-versiebeheeropdrachten gebruiken voor meer informatie over het gebruik van het tf opdrachtregelprogramma.

Voorbeelden

In het volgende voorbeeld wordt de naam van 314.cs gewijzigd in 1254.cs.

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

In het volgende voorbeeld wordt de naam van 314.cs gewijzigd in 1254.cs en verplaatst u deze naar de map newdir .

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

In het volgende voorbeeld wordt de naam van Form1.vb gewijzigd in MainPage.vb en wordt er een vergrendeling op toegepast.

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