Udostępnij za pośrednictwem

Zmień nazwę polecenia (Kontrola wersji serwera Team Foundation)

  • Artykuł

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

Visual Studio 2019 | Visual Studio 2022

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

Uwaga

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.

Wymagania wstępne

Aby użyć rename polecenia, musisz mieć uprawnienie Wyewidencjonowywanie ustawione na Zezwalaj. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

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

Parametry

Argumenty

Argument

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ść /login opcji. Możesz określić wartość nazwy użytkownika jako DOMAIN\username lub username.

Opcje

Opcja

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 w zablokowanych plikach, 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 tf narzędzia wiersza polecenia, aby przenieść lub zmienić nazwę elementu kontrolowanego wersją w obszarze roboczym. rename Użyj polecenia , 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:

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

Jeśli zostanie określony newitem folder, który określa nieistniejący folder, rename polecenie tworzy 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. Możesz zmieniać nazwy elementów w obszarze MyApp, ale nie w samej aplikacji MyApp .

Aby uzyskać więcej informacji na temat korzystania z tf narzędzia wiersza polecenia, zobacz Use Team Foundation version control commands (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 go 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