Udostępnij za pośrednictwem


Usuń polecenie (Kontrola wersji serwera Team Foundation)

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

Visual Studio 2019 | Visual Studio 2022

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

Uwaga

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.

Wymagania wstępne

Aby użyć delete polecenia, musisz mieć uprawnienie Wyewidencjonowywanie ustawione na Zezwalaj. Jeśli dołączysz /lock opcję z wartością inną niż none, musisz mieć uprawnienie Blokada ustawioną na wartość Zezwalaj. Musisz również być właścicielem obszaru roboczego lub mieć uprawnienia globalne Administracja ister workspaces ustawione na Zezwalaj. Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

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

Parametry

Argumenty

Argument

Opis

<itemspec>

Identyfikuje plik lub folder do usunięcia z serwera usługi Azure DevOps. Aby uzyskać więcej informacji o sposobie analizowania kontrolera TFVC w itemspec celu określenia, które elementy znajdują się w zakresie, zobacz Use options to modify how a command functions (Używanie opcji do modyfikowania sposobu działania polecenia).

Uwaga

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

<username>

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

Opcje

Opcja

Opis

/lock

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

Opcje blokady:

  • none
    Domyślne. 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 itemspec z określonym katalogem.

  • tf delete <folder1>\<folder2> /recursiveUsuwa wszystkie pliki i podkatalogi zawarte w folderze folder1>\<folder2> i <folder1>\<folder2>.<
  • tf delete <folder1>\<folder2> <filespec> /recursiveUsuwa wszystkie pliki i podkatalogi pasujące do filespec<folderu folder1>\<folder2> i każdy z jego podkatalogów, a także wszystkie pliki i podkatalogi zawarte w dowolnym katalogu, który pasuje do .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, a następnie 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 za pomocą checkin polecenia tfVC usuwa element z serwera Usługi Azure DevOps, ale nie usuwa go trwale. Elementy usunięte można zlokalizować na serwerze Usługi Azure DevOps za pomocą dir polecenia i przywrócić usunięte elementy za pomocą polecenia Cofnij usunięcie.

Jeśli element został usunięty w obszarze roboczym, ale nie zaewidencjonował zmiany, możesz przywrócić element do obszaru roboczego i usunąć usunięcie z listy oczekujących zmian za pomocą 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ę undo przy użyciu polecenia .

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.

itemspec Gdy określasz 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 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 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 bez trwałej.

tf delete 314.cs