Compartilhar via

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

Azure DevOps Services | Servidor Azure DevOps | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

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

Nota

Os resultados desse comando não ficam 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

Categoria Requirements
Permissões - Conjunto de permissões de check-out para Permitir.
- Se você incluir a opção /lock com um valor diferente nonede: bloquear a permissão definida como Permitir.
- Proprietário do workspace ou da permissão Administrar workspaces definido comoPermitir.

Para obter mais informações, consulte permissões TFVC padrão.

Sintaxe

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

Parâmetros

Argumentos

de argumento

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 opções para modificar como um comando funciona.

Nota

Você pode especificar mais de um argumento itemspec.

<username>

Fornece 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 entrem ou confiram os itens especificados. Para obter mais informações, consulte Understanding Lock Types.

Opções de bloqueio:

  • none
    Inadimplência. 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 executando um check-in. Se outros usuários bloquearem 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 bloquearem qualquer um dos itens especificados, a operação de bloqueio falhará.

/recursive

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

  • tf delete <folder1>\<folder2> /recursive exclui todos os arquivos e subdiretórios contidos por <pasta1>\<pasta2>e <pasta1>\<pasta2> si mesmo.
  • tf delete <folder1>\<folder2> <filespec> /recursive exclui todos os arquivos e subdiretórios correspondentes aos filespec contidos em <pasta1>\<pasta2> 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 pasta1\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.

Observações

O comando delete registra uma alteração pendente do tipo delete em seu workspace para os itens especificados. Quando você confirma uma alteração pendente do tipo delete para o 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 comando Undelete.

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 Desfazer.

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ê faz check-in de 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 o 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 em disco na pasta de workspace local especificada e, quando você faz check-in da alteração, remove 314.cs do sistema de controle de versão de forma não permanente.

tf delete 314.cs
  • Last updated on