Udostępnij za pośrednictwem

Usuń polecenie (Kontrola wersji programu Team Foundation)

  • Artykuł

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

Visual Studio 2019 | Program Visual Studio 2022

Polecenie delete usuwa pliki i foldery z serwera Usługi Azure DevOps i usuwa je z dysku.

Nuta

Wyniki tego polecenia nie są widoczne w innych obszarach roboczych, dopóki nie wykonasz operacji zaewidencjonowania. Aby uzyskać więcej informacji, zobacz Tworzenie kodu i zarządzanie oczekującymi zmianami.

Warunki wstępne

Aby użyć polecenia delete, upewnij się, że wyewidencjonuj uprawnienie Zezwalaj na. Jeśli dołączysz opcję z wartością inną niż , ustaw uprawnienie blokady Zezwalaj na. Musisz również być właścicielem obszaru roboczego lub mieć uprawnienia globalne Administrowanie obszarami roboczymi ustawioną na Zezwalaj na. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia serwera TFVC.

Składnia

tf delete [/lock:(none|checkin|checkout)] [/recursive] [/login:username,[password]] itemspec

Parametry

Argumenty

argumentów

opis

<itemspec>

Identyfikuje plik lub folder do usunięcia z serwera usługi Azure DevOps. Aby uzyskać więcej informacji na temat analizowania itemspec w celu określenia, które elementy znajdują się w zakresie, zobacz Use options to modify how a command functions.

Nuta

Można określić więcej niż jeden argument itemspec.

<username>

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

Opcje

opcji

opis

/lock

Uniemożliwia innym użytkownikom zaewidencjonowanie lub wyewidencjonowanie określonych elementów. Aby uzyskać więcej informacji, zobacz Understanding Lock Types.

Opcje blokady:

  • none
    Domyślny. Nie zastosowano blokady. Jeśli na określonym pliku została umieszczona blokada, ta opcja spowoduje jego usunięcie. Nie powoduje usunięcia blokady umieszczonej przez inną osobę.

  • checkin
    Inni użytkownicy mogą wyewidencjonować określone elementy, ale nie mogą zaewidencjonować poprawek w zablokowanych plikach, dopóki nie zwolnisz blokady, wykonując zaewidencjonowywanie. 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 wykonanie ewidencjonowania. Jeśli inni użytkownicy zablokowali dowolny z określonych elementów, operacja blokowania zakończy się niepowodzeniem.

/recursive

Usuwa wszystkie pliki i/lub foldery i podfoldery zgodne z itemspec z określonego katalogu.

  • tf delete <folder1>\<folder2> /recursive usuwa wszystkie pliki i podkatalogi zawarte w folderze <1>\<folder2>, a folder <folder1>\<folder2>.
  • tf delete <folder1>\<folder2> <filespec> /recursive usuwa wszystkie pliki i podkatalogi zgodne z filespec zawarte w folderze <1>\<folder2> i każdy z jego podkatalogów, a także wszystkie pliki i podkatalogi zawarte w dowolnym katalogu zgodnym z filespec.

Na przykład w obszarze roboczym zawierającym:

Folder1\AVeryLongDirectoryName z niektórymi plikami wewnątrz i Folder1\Folder2\AVeryImportantFile.txt,

tf delete Folder1 AVer* /recursive

Usuwa Folder1\AVeryLongDirectoryName i wszystkie jego pliki oraz usuwa Folder1\Folder2\AVeryImportantFile.txt, ponieważ pasuje do symbolu wieloznacznego.

/login

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

Uwagi

Polecenie delete rejestruje oczekującą zmianę typu delete w obszarze roboczym dla elementów, które określisz. Po zatwierdzeniu oczekującej zmiany typu delete na serwerze Usługi Azure DevOps przy użyciu polecenia checkin serwer TFVC usuwa element z serwera Usługi Azure DevOps, ale nie usuwa go trwale. Elementy usunięte można znaleźć na serwerze usługi Azure DevOps przy użyciu polecenia dir i przywrócić usunięte elementy przy użyciu polecenia Cofanie usuwania.

Jeśli element został usunięty w obszarze roboczym, ale nie został zaewidencjonowany, możesz przywrócić element do obszaru roboczego i usunąć usunięcie z listy oczekujących zmian przy użyciu polecenia Cofnij.

Nie można usunąć elementu, dla którego istnieje inna oczekująca zmiana. Na przykład nie można usunąć wyewidencjonowanego pliku. Aby usunąć takie elementy, należy cofnąć bieżącą oczekującą zmianę przy użyciu polecenia undo.

Po zaewidencjonowanym oczekującym usunięciu kontroler TFVC oznacza plik jako usunięty na serwerze usługi Azure DevOps. Następnie uruchomienie get elementu z innych obszarów roboczych przez Ciebie lub innych użytkowników powoduje usunięcie elementu z tych obszarów roboczych.

Gdy itemspec określa folder, serwer TFVC domyślnie usuwa wszystkie jego pliki i podfoldery oraz pliki, które zawierają.

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 usuwa 314.cs na dysku w określonym lokalnym folderze obszaru roboczego, a następnie po zaewidencjonowania zmiany usuwa 314.cs z systemu kontroli wersji nietrwałe.

tf delete 314.cs