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

  • Artigo

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

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

Nota

Os resultados desse comando não são visíveis em outros espaços de trabalho 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 delete comando, você deve ter a permissão Check-out definida como Permitir. Se você incluir a /lock opção com um valor diferente de none, deverá ter a permissão Bloquear definida como Permitir. Você também deve ser o proprietário do espaço de trabalho ou ter a permissão global Administrar espaços de trabalho definida como Permitir. 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

Argumento

Descrição

<itemspec>

Identifica o arquivo ou pasta a ser excluído do servidor de DevOps do Azure. 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 o funcionamento de um comando.

Nota

Você pode especificar mais de um itemspec argumento.

<username>

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

Opções

Opção

Descrição

/lock

Impede que outros usuários façam check-in ou check-out dos itens especificados. Para obter mais informações, consulte Noções básicas sobre tipos de bloqueio.

Opções de bloqueio:

  • none
    Predefinição. Nenhum bloqueio é aplicado. Se tiver colocado um bloqueio no ficheiro especificado, esta opção remove-o. Não remove um cadeado 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 de arquivos bloqueados até que você libere o bloqueio executando um check-in. Se qualquer outro usuário tiver bloqueado qualquer um dos itens especificados, a operação de bloqueio falhará.

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

/recursive

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

  • tf delete <folder1>\<folder2> /recursiveExclui 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 espaço de trabalho contendo:

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.

Observações

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

Se você excluiu um item em seu espaço de trabalho, mas não fez check-in da alteração, você pode restaurar o item para seu espaço de trabalho e remover a exclusão da sua lista de alterações pendentes usando o comando Desfazer.

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

Quando você faz check-in de uma exclusão pendente, o TFVC marca o arquivo como excluído no servidor de DevOps do Azure. Subsequentemente, a execução de um get item de outros espaços de trabalho, seja por você ou por outros usuários, exclui o item desses espaços de trabalho.

Quando você 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 tf comando, consulte Usar comandos de controle de versão do Team Foundation.

Exemplos

O exemplo a seguir exclui 314.cs no disco na pasta de espaço de trabalho local especificada e, em seguida, quando você faz check-in da alteração, remove 314.cs do sistema de controle de versão não permanentemente.

tf delete 314.cs