Udostępnij za pośrednictwem

Zmień nazwę polecenia (Team Foundation Version Control)

  • Artykuł

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Program Visual Studio 2022

Polecenie Kontroli wersji programu Team Foundation (TFVC) rename zmienia nazwę lub ścieżkę pliku lub folderu. Możesz użyć polecenia rename lub aliasów move lub ren, aby przenieść plik lub folder do nowej lokalizacji.

Nuta

Wyniki tego polecenia nie zostaną odzwierciedlone na serwerze do momentu zaewidencjonowania. Aby uzyskać więcej informacji, zobacz Tworzenie kodu i zarządzanie oczekującymi zmianami.

Warunki wstępne

Aby użyć polecenia rename, upewnij się, że wyewidencjonuj uprawnienie Zezwalaj na. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia serwera TFVC.

Składnia

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

Parametry

Argumenty

argumentów

opis

<olditem>

Oryginalna nazwa i ścieżka pliku lub folderu do zmiany nazwy. Możesz określić lokalną ścieżkę obszaru roboczego, taką jak C:\myfiles\314.cs lub ścieżkę serwera TFVC, taką jak $/myfiles/314.cs.

<newitem>

Nowa nazwa pliku lub folderu. Możesz użyć tej opcji, aby określić inną lokalizację ścieżki serwera serwera lub lokalizacji serwera TFVC.

<username>

Udostępnia wartość opcji /login. Możesz określić wartość nazwy użytkownika jako DOMAIN\username lub username.

Opcje

opcji

opis

/lock

Uwzględnij tę opcję, aby uniemożliwić innym użytkownikom ewidencjonowanie lub wyewidencjonowanie określonych elementów. Jeśli ta opcja nie zostanie określona, istniejący stan blokady elementu nie zostanie zmieniony. Aby uzyskać więcej informacji, zobacz Omówienie typów blokad.

Opcje blokady:

  • None: nie zastosowano blokady.
  • Checkin: Inni użytkownicy mogą wyewidencjonować określone elementy, ale nie mogą zaewidencjonować poprawek zablokowanych plików, dopóki nie zwolnisz blokady, wykonując ewidencjonowania. Jeśli inni użytkownicy zablokowali dowolny z określonych elementów, operacja blokowania zakończy się niepowodzeniem.
  • Checkout: uniemożliwia innym użytkownikom zaewidencjonowanie lub wyewidencjonowanie dowolnego z określonych elementów do momentu zwolnienia blokady przez zaewidencjonowanie. Jeśli inni użytkownicy zablokowali dowolny z określonych elementów, operacja blokowania zakończy się niepowodzeniem.

/login

Określa nazwę użytkownika i hasło do uwierzytelniania użytkownika w usłudze Azure DevOps.

Uwagi

Możesz użyć rename polecenia narzędzia wiersza polecenia tf, aby przenieść lub zmienić nazwę elementu kontrolowanego przez wersję w obszarze roboczym. Użyj polecenia rename, aby przenieść wiele plików, określając symbole wieloznaczne. Możliwość zmiany nazwy wielu plików lub folderów kontrolowanych przez wersję jest dostępna tylko z wiersza polecenia.

Użyj polecenia rename, aby wykonać następujące czynności:

  • Zmień nazwę olditem na newitem, na przykład tf rename 314.cs 315.cs.
  • Przenieś olditem do nowej lokalizacji na serwerze TFVC, podając newitem, którego ścieżka różni się od tej olditem, takiej jak tf rename 314.cs ..\newdir\314.cs.

Jeśli podasz newitem, który określa nieistniejący folder, polecenie rename utworzy folder docelowy. Jeśli newitem jest folderem, olditem staje się elementem podrzędnym newitem.

Nie można zmienić nazwy elementu, jeśli:

  • Usunięto go już przed zaewidencjonowanym w tym samym obszarze roboczym.
  • Nowa nazwa już istnieje na serwerze TFVC i nie jest folderem.
  • Dodano już, rozgałęziono lub zmieniono nazwę oczekującego zaewidencjonowania elementu.
  • Element jest mapowany w obszarze roboczym, ale nie jest dostępny na dysku lokalnym.
  • Element jest zamaskowany.

Możesz zmienić nazwę elementu, dla którego został dodany inny plik o tej samej nazwie, ale nie można zmienić nazwy elementu, który został rozgałęziony, ale nie został jeszcze zaewidencjonowany. Po zmianie nazwy pliku, który ma oczekujące zmiany, zmiany są zachowywane.

Nie można zmienić nazwy elementu, który jest jawnie mapowany, bez uprzedniej zmiany mapowania. Jeśli na przykład istnieje mapowanie folderu roboczego $/ProjectX/MyApp na c:\MyApp, nie można zmienić nazwy MyApp. Elementy można zmienić w obszarze MyApp, ale nie aplikacji MyApp.

Aby uzyskać więcej informacji na temat korzystania z narzędzia wiersza polecenia tf, zobacz Używanie poleceń kontroli wersji programu Team Foundation.

Przykłady

Poniższy przykład zmienia nazwę 314.cs na 1254.cs.

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

Poniższy przykład zmienia nazwę 314.cs na 1254.cs i przenosi ją do folderu newdir.

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

Poniższy przykład zmienia nazwę Form1.vb na MainPage.vb i stosuje do niej blokadę.

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