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

De opdracht Team Foundation Version Control (TFVC) rename wijzigt de naam of het pad van een bestand of map. U kunt de opdracht rename of de aliassen move of rengebruiken 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 beherenvoor meer informatie.

Voorwaarden

Als u de opdracht rename wilt gebruiken, moet u de machtiging uitchecken ingesteld op toestaan. Zie standaard TFVC-machtigingenvoor 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 optie /login. U kunt een gebruikersnaamwaarde opgeven als DOMAIN\username of 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 Inzicht in vergrendelingstypenvoor 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 incheckbewerking uit te voeren. Als andere gebruikers een van de opgegeven items hebben vergrendeld, mislukt de vergrendelingsbewerking.
  • Checkout: voorkomt 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 opdrachtregelprogramma tf gebruiken om een door versie beheerd item in uw werkruimte te verplaatsen of de naam ervan te wijzigen. Gebruik de opdracht rename 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 opdracht rename om de volgende acties uit te voeren:

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

Als u een newitem opgeeft waarmee een niet-bestaande map wordt opgegeven, maakt de rename opdracht de doelmap. Als newitem een map is, wordt olditem 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 van $/ProjectX/MyApp- is om c:\MyAppte , kunt u de naam van MyApp-niet wijzigen. U kunt de naam van items wijzigen onder MyApp, maar niet MyApp zelf.

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

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