Destroy Command

Use o tf destroy comando destruir ou excluir permanentemente, arquivos com controle de versão do Controle de versão do Team Foundation.

Não é possível reverter a ação de destruição.Você não deve destruir arquivos que ainda são necessários.Às vezes, você precisa limpar os sistemas de controle de versão.Por exemplo, se alguns arquivos estão infectados com um vírus de computador, você precisará removê-los permanentemente do controle de versão.

Antes de executar tf destroy sem o /keephistory opção, é recomendável que você primeiro excluir os arquivos que deseja destruir. Para obter mais informações, consulte Como: Excluir arquivos e pastas do Controlarar de versão.

Após excluir os arquivos, você pode sincronizar o Team Foundation depósito. Caso contrário, o depósito não será sincronizado com os itens destruídos.Para obter mais informações, consulte AgenDadosmento de sincronização com o Dadosta warehouse.

Permissões necessárias

Para usar o destroy comando, você deve pertencer à Equipe Foundation administradores agrupar de segurança.Para obter mais informações, consulte Permissões de Team Foundation Servidor.

tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>…<itemspecN>] 
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt]

Parâmetros

Argumento	Descrição
itemspec1[itemspec2…itemspecN]	Especifica o caminho do servidor do arquivo ou pasta a ser destruído.Usar vários itemspec valores para excluir vários itens. Por exemplo, tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3. Não há suporte para caminhos locais.
versionspec	Fornece uma versão sistema autônomo C58 o /keephistory ou /stopat opções. Os valores permitidos são data, dica ou um conjunto de alterações específico.Para obter mais informações sobre como Team Foundation analisa uma especificação de versão para determinar quais itens estão dentro do seu escopo, consulte Sintaxe de linha de comando (Team Sistema).

Opção	Descrição
/keephistory	Opcional.Especifica que o histórico de um arquivo é preservado, mesmo que seu Sumário é destruído.Isso não pode ser especificado com o /preview opção.
/stopat	Opcional.Pode ser usado somente se /keephistory é também especificado. Especifica a versão do arquivo para o arquivo e os arquivos a partir de então, siga para a qual o histórico é mantido. A versão padrão de /stopat é a dica (T) para obter a versão mais recente com check-in de um item. Não é possível usar o espaço de trabalho ou rótulo versionspec valores para especificar um item para /stopat opção.
/preview	Exibe na janela aviso de comando os arquivos que poderiam ser destruídos.Quando tf destroy é executado no modo de visualização, os arquivos não são destruídos realmente. Observação: O texto a C omando Prompt janela exibirá a palavra "Destroyed" com cada arquivo que deve ser destruído .No entanto, o arquivo é Na verdade não destruído Quando o /preview opção é usada.
/startcleanup	Força o processo de limpeza de conteúdo do arquivo para iniciar imediatamente após a exclusão do conteúdo termina.Se o usuário não especificar /startcleanup, o conteúdo destruído clean - up processo ocorre quando a manutenção de banco de dados limpa todos os arquivos que não são referenciados por Team Foundation Server. Por padrão, a limpeza está programada para executar uma vez por dia.
/noprompt /i	Especifica que a destruição de arquivos não-interativa./i é um alias para /noprompt.

Comentários

Quando você usa tf destroy para destruir arquivos de controle de versão, a camada de aplicativo do Team Foundation Server recebe a solicitação de destruição e verificações para ver se é um membro das Equipe Foundation administradores agrupar de segurança.Se você não for um membro, o sistema exibe uma caixa de diálogo de mensagem de erro informando que você não tem permissões suficientes para executar a operação.

Depois que o sistema verifica as permissões, ele executa o comando destroy.Este comando exclui todas as referências de arquivo, shelvesets e as alterações pendentes.A destruição real de arquivos, que é uma exclusão permanente, ocorrer na próxima vez que o conteúdo que não tenha mais referenciado por Team Foundation Server é limpa. Você também pode especificar o /startcleanup opção para limpar os arquivos imediatamente após tf destroy é executado.

Se você executar o tf destroy sem especificar /i e /preview, o sistema exibe um console Yes ou No aviso para cada filespec valor. Caso contrário, você pode especificar Yes to all. Se você não especificar /keephistory, você será solicitado por um texto interativo avisa das alterações, pendentes se elas existirem. Os pontos de texto interativo para /preview Se você quiser obter mais informações sobre as alterações. Se você especificar /keephistory, também é solicitado por Yes, No, ou All texto. Se você selecionar Yes ou All, do início do processo de destruição e os caminhos de servidor para os itens destruídos aparecem no janela do aviso de comando.

Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: …

Se você tiver especificado o versionspec valor sistema autônomo uma dica, sistema autônomo caminhos de servidor exibidos no janela do aviso de comando incluem exclusão IDs. Por exemplo, 123 X pode aparecer no aviso de comando janela.

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

Destruído: $/Test1/MyProject/MyProject/programa.cs

No entanto, o arquivo, na verdade, não será destruído porque você usou o /preview opção.

Para obter mais informações sobre como localizar o TF utilitário de linha de comando, consulte Comandos do utilitário de linha de comando TF.

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

Se você especificar o /keephistory opção para manter o histórico de arquivos destruídos, sistema autônomo arquivos são tratados sistema autônomo destruído pelo seguinte Controle de versão do Team Foundation operações:

• **Alterar o conteúdo   **Se você tenta alterar o conteúdo de um arquivo destruído, por exemplo edição ou ramificar, o sistema emitirá uma mensagem de erro a indicar o conteúdo tiver sido destruído.

• **Filiais, mesclagem ou desfazer check-in particular   **Se você tentar de filiais, mesclagem ou desfazer check-in particular destruído itens, os problemas de sistema de uma mensagem de erro a indicar o conteúdo dos itens foi destruída.

Destruindo anteriormente itens excluídos

Se um item já tiver sido excluído, uma ID de exclusão é anexada a ele e resultados em uma alterar de nome de arquivo.

Exemplos

Descrição

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

Código

C:\pi\ws1>tf destroy $/proj/pi/a.cs

Descrição

O exemplo a seguir exclui uma pasta, aFolder, tipo de linha de comando:

Código

C:\tf delete $/MyTeamProject/aFolder

Descrição

Para destruir o item excluído, aFolder, você deve digitar na linha de comando:

Código

tf destroy $/MyTeamProject/sFolder;x123

Onde x 123 é a ID de exclusão.

Consulte também

Tarefas

Como: Destruir versão controlado por arquivos

Conceitos

Operações disponíveis apenas de linha de comando (@@)

Outros recursos

Comandos do utilitário de linha de comando TF