Compartilhar via

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

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Use o comando tf destroy para destruir ou excluir permanentemente arquivos controlados por versão do TFVC (Controle de Versão do Team Foundation).

Nota

A exclusão de um repositório TFVC dentro do Azure Devops não é permitida depois que ele é criado. O comando tf destroy destruirá ou excluirá permanentemente arquivos ou pastas controlados por versão, mas não excluirá o repositório TFVC. Ele ainda aparecerá na lista de opções com a mensagem excluída.

Às vezes, você precisa limpar sistemas de controle de versão. Por exemplo, se alguns arquivos estiverem infectados com um vírus de computador, você precisará removê-los permanentemente do controle de versão. Não destrua arquivos que ainda são necessários. A ação de destruição não pode ser revertida.

Antes de executar tf destroy sem a opção /keephistory, primeiro exclua os arquivos que deseja destruir. Para obter mais informações, consulte Excluir arquivos e pastas do controle de versão.

Depois de excluir os arquivos, você pode sincronizar o armazém do TFVC. Caso contrário, o armazém não será sincronizado com os itens destruídos.

Pré-requisitos

Para usar o comando , pertença ao grupo de segurança administradores Team Foundation. Para obter mais informações, consulte permissões TFVC padrão.

Sintaxe

tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>] 
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]

Parâmetros

Argumentos

de argumento

descrição

<itemspec1> [<itemspec2>...<itemspecN>]

Especifica o caminho do servidor do arquivo ou pasta a ser destruído. Use vários valores itemspec para excluir vários itens. Por exemplo, tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3.

Não há suporte para caminhos locais.

<versionspec>

Fornece uma versão como C58 para as opções de /keephistory ou /stopat. Os valores permitidos são date, tipou um conjunto de alterações específico. Para obter mais informações sobre como o TFVC analisa uma especificação de versão para determinar quais itens estão dentro de seu escopo, consulte Usar comandos de controle de versão do Team Foundation.

<username>

Fornece um valor para a opção /login. Você pode especificar um valor username como DOMAIN\username ou username.

TeamProjectCollectionUrl

A URL da coleção de projetos que contém arquivos que você deseja destruir, por exemplo, http://myserver:8080/tfs/DefaultCollection.

Opções

opção

descrição

/keephistory

Opcional. Especifica que o histórico de um arquivo é preservado mesmo quando seu conteúdo é destruído. Essa opção não pode ser especificada com a opção /preview.

/stopat

Opcional. Só poderá ser usado se /keephistory for especificado também.

Especifica a versão do arquivo e os arquivos que seguem depois disso, para os quais o histórico é preservado.

A versão padrão para /stopat é tip (T) para a versão de check-in mais recente de um item.

Você não pode usar valores de versionspec de rótulo ou workspace para especificar um item para a opção /stopat.

/preview

Exibe os arquivos que seriam destruídos na janela do prompt de comando. Quando tf destroy é executado no modo de visualização, os arquivos não são realmente destruídos.

Nota

O texto na janela do prompt de comando exibe a palavra destruído com cada arquivo que seria destruído. No entanto, o arquivo não é realmente destruído quando a opção /preview é usada.

/startcleanup

Força o processo de limpeza de metadados do TFVC a ser iniciado imediatamente após a conclusão da exclusão. Se o usuário não especificar /startcleanup, o processo de limpeza de metadados destruído ocorrerá quando a manutenção do banco de dados limpar todos os arquivos que não são mais referenciados pelo Servidor de DevOps do Azure. Por padrão, a limpeza é agendada para ser executada a cada cinco dias. Sete dias após a limpeza dos metadados do TFVC, o conteúdo é excluído por outro processo de limpeza. Por padrão, esse processo de limpeza de conteúdo é executado uma vez por dia.

/noprompt ou /i

Especifica que a destruição de arquivos não é interativa. /i é um alias para /noprompt.

/silent

Especifica que, quando você destrói arquivos ou pastas, a saída não é gravada na janela do prompt de comando.

/login

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

/collection

Especifica a coleção de projetos.

Observações

Quando você usa para destruir arquivos de controle de versão, a camada de aplicativo do TFVC recebe a solicitação de destruição e verifica se você é membro do grupo de segurança administradores Team Foundation. Se você não for membro, o sistema exibirá uma caixa de diálogo de mensagem de erro que informa que você não tem permissões suficientes para executar a operação.

Depois que o sistema verifica suas permissões, ele executa o comando destroy. Esse comando exclui todas as referências de arquivo, conjuntos de prateleiras e alterações pendentes. A destruição real de arquivos, que é uma exclusão permanente, acontece na próxima vez que o conteúdo que não é mais referenciado pelo Servidor de DevOps do Azure for limpo. Você também pode especificar a opção /startcleanup para limpar os arquivos imediatamente após a execução do tf destroy.

Se você executar tf destroy sem especificar /i e /preview, o sistema exibirá um console Sim ou Nenhum prompt de para cada valor filespec. Caso contrário, você poderá especificar Sim para Todos os.

  • Se você não especificar /keephistory, será solicitado por um texto interativo que avisa sobre alterações pendentes, se elas existirem. O texto interativo aponta para /preview se você quiser mais informações sobre as alterações.

  • Se você especificar /keephistory, você também será solicitado por texto Sim, Semou Sim para Todos os. Se você selecionar Sim ou Sim para Todos os, o processo de destruição será iniciado e os caminhos do servidor para os itens destruídos aparecerão na janela do prompt de comando.

Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...

Se você especificou o valor versionspec como tip, os caminhos do servidor exibidos na janela do prompt de comando incluem IDs de exclusão. Por exemplo, Destroyed: $/Test1/MyProject;X123 pode aparecer na janela do prompt de comando.

Se você usar a opção /preview, os arquivos não serão destruídos, mas o texto da linha de comando exibirá os arquivos que serão destruídos. Por exemplo, se você inserir tf destroy /preview $/Test1/MyProject/MyProject/Program.cs na linha de comando, a janela de comando exibirá este texto:

Destroyed: $/Test1/MyProject/MyProject/Program.cs

No entanto, o arquivo não é realmente destruído porque você usou a opção /preview.

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.

Efeitos do /keephistory em outras operações de controle de versão

Se você especificar a opção /keephistory para manter o histórico de arquivos destruídos, os arquivos serão tratados como destruídos pelas seguintes operações do TFVC:

  • Alterarde conteúdo. Se você tentar alterar o conteúdo de um arquivo destruído, por exemplo, editar ou ramificar, o sistema emitirá uma mensagem de erro informando que o conteúdo foi destruído.

  • Branch, mesclagem ouinútil. Se você tentar ramificar, mesclar ou desacompartir itens destruídos, o sistema emitirá uma mensagem de erro informando que o conteúdo dos itens foi destruído.

Destruir itens excluídos anteriormente

Se um item já tiver sido excluído, uma ID de exclusão será anexada a ele e resultará em uma alteração de nome de arquivo.

A pesquisa de código não lida com tf destroy notificações, portanto, usar tf destroy para repositórios TFVC não excluirá automaticamente arquivos do índice de pesquisa. Como resultado, esses arquivos aparecem nos resultados da pesquisa de código. Para evitar esses cenários de arquivos fantasmas, exclua arquivos antes da operação de tf destroy.

Exemplos

O exemplo a seguir exclui permanentemente o arquivo a.cs.

tf destroy $/proj/pi/a.cs

O exemplo a seguir exclui uma pasta, aFolder:

tf delete $/MyTeamProject/aFolder

Para destruir o item excluído aFolder, digite na linha de comando:

tf destroy $/MyTeamProject/aFolder;x123

onde x123 é a ID de exclusão.