Comando Delete (Controle de Versão do Team Foundation)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

O comando delete remove arquivos e pastas do servidor do Azure DevOps e os exclui do disco.

Observação

Os resultados desse comando não são visíveis em outros workspaces até que você execute uma operação de check-in. Para obter mais informações, consulte Desenvolver código e gerenciar alterações pendentes.

Pré-requisitos

Para usar o comando delete, você deve ter a permissão de Check-out definida como Permitir. Se você incluir a opção /lock com um valor diferente de none, deverá ter a permissão Bloquear definida como Permitir. Você deve possuir o workspace ou ter a permissão global Administrar workspacesdefinida como Permitir. Para saber mais, confira Permissões padrão do TFVC.

Sintaxe

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

Parâmetros

Argumentos

Argument

Descrição

<itemspec>

Identifica o arquivo ou pasta a ser excluído do servidor do Azure DevOps. Para obter mais informações sobre como o TFVC analisa um itemspec para determinar quais itens estão dentro do escopo, consulte Usar comandos de controle de versão do Team Foundation.

Observação

Você pode especificar mais de um argumento itemspec.

<username>

Mostra um valor para a opção /login. Você pode especificar um valor de nome de usuário como DOMAIN\username ou username.

Opções

Opção

Descrição

/lock

Impede que outros usuários verifiquem ou verifiquem os arquivos especificados. Para obter mais informações, consulte Noções básicas sobre tipos de bloqueio.

Opções de bloqueio:

  • none
    Padrão. Nenhum bloqueio é aplicado. Se você colocou um bloqueio no arquivo especificado, essa opção o removerá. Ele não remove um bloqueio colocado por outra pessoa.

  • checkin
    Outros usuários podem fazer check-out dos itens especificados, mas não podem fazer check-in de revisões para arquivos bloqueados até que você libere o bloqueio fazendo um check-in. Se outros usuários tiverem bloqueado qualquer um dos itens especificados, a operação de bloqueio falhará.

  • checkout
    Impede que outros usuários faça check-in ou faça check-out de qualquer um dos itens especificados até que você libere o bloqueio executando um check-in. Se outros usuários tiverem bloqueado qualquer um dos itens especificados, a operação de bloqueio falhará.

/recursive

Exclui todos os arquivos e/ou pastas e subpastas que correspondem o itemspec do diretório especificado.

  • tf delete <folder1>\<folder2> /recursive exclui todos os arquivos e subdiretórios contidos por <folder1>\<folder2> e <folder1>\<folder2> em si.
  • tf delete <folder1>\<folder2> <filespec> /recursive exclui todos os arquivos e subdiretórios correspondentes ao filespec contido em <folder1>\<folder2> e cada um de seus subdiretórios, bem como todos os arquivos e subdiretórios contidos em qualquer diretório que corresponda ao filespec.

Por exemplo, em um workspace que contém:

Folder1\AVeryLongDirectoryName com alguns arquivos dentro e Folder1\Folder2\AVeryImportantFile.txt,

tf delete Folder1 AVer* /recursive

exclui Folder1\AVeryLongDirectoryName e todos os seus arquivos e exclui Folder1\Folder2\AVeryImportantFile.txt porque corresponde ao caractere curinga.

/login

Especifica o nome de usuário e a senha para autenticar o usuário com o Azure DevOps.

Comentários

O comando delete registra uma alteração pendente de tipo delete em seu workspace para os itens que você especificar. Quando você confirma uma alteração pendente do tipo delete no servidor do Azure DevOps usando o comando checkin, o TFVC remove o item do servidor do Azure DevOps, mas não o exclui permanentemente. Você pode localizar itens excluídos no servidor do Azure DevOps usando o comando dir e restaurar itens excluídos usando o comandoUndelete.

Se você excluiu um item em seu workspace, mas não fez check-in na alteração, poderá restaurar o item para seu workspace e remover a exclusão da lista de alterações pendentes usando o comando Undo.

Não é possível excluir um item para o qual existe outra alteração pendente. Por exemplo, um arquivo de check-out não pode ser excluído. Para excluir esses itens, você deve desfazer a alteração pendente atual usando o comando undo.

Quando você marcar em uma exclusão pendente, o TFVC marca o arquivo como excluído no servidor do Azure DevOps. Posteriormente, a execução de um get do item de outros workspaces, por você ou outros usuários, exclui o item desses workspaces.

Quando itemspec especifica uma pasta, o TFVC exclui todos os seus arquivos e subpastas e os arquivos que eles contêm, por padrão.

Para obter mais informações sobre como usar o utilitário de linha de comando tf, consulte Usar comandos de controle de versão do Team Foundation.

Exemplos

O exemplo a seguir exclui 314.cs no disco na pasta de workspace local especificada e, quando você marcar na alteração, remove 314.cs do sistema de controle de versão não permanentemente.

tf delete 314.cs