Destruir o comando (Team Foundation Version Control)
Use o tf destroy comando para destruir, ou excluir permanentemente, os arquivos de controle de versão do Controle de versão do Team Foundation.
A ação de destruição não pode ser revertida. Não, você deverá destruir arquivos que ainda são necessários. Às vezes é necessário limpar os sistemas de controle de versão. Por exemplo, se alguns arquivos estão infectados com um vírus de computador, precisará removê-los permanentemente do controle de versão.
Antes de executar tf destroy sem a /keephistory opção, recomendamos que você exclua primeiro os arquivos que deseja destruir. For more information, see Excluir arquivos e pastas no controle de versão.
Após excluir os arquivos que você pode sincronizar o Team Foundation depósito. Caso contrário, o depósito não será sincronizado com os itens destruídos.
Permissões necessárias
Para usar o destroy de comando, você deve pertencer à Os administradores do Team Foundation o grupo de segurança. For more information, see Permissões de Team Foundation Server.
tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>]
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]
Parâmetros
Argument |
Description |
|---|---|
itemspec1 [itemspec2…itemspecN] |
Especifica o caminho do servidor do arquivo ou pasta a ser destruído. Usar várias itemspec valores para excluir vários itens. For example, tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3. Não há suporte para caminhos locais. |
versionspec |
Fornece uma versão como, por exemplo, C58 para o /keephistory ou /stopat Opções. Os valores permitidos são: data, dica ou um changeset 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 de seu escopo, consulte Sintaxe de linha de comando (controle de versão). |
username |
Fornece um valor para o /login opção. Você pode especificar um valor de username como domínio\nome de usuário ou nome de usuário. |
TeamProjectCollectionUrl |
A URL da coleção de projeto de equipe que contém os arquivos que você deseja destruir (por exemplo, http://myserver:8080/tfs/DefaultCollection). |
Option |
Description |
|---|---|
/keephistory |
Optional. Especifica que o histórico de um arquivo é preservado, mesmo que seu conteúdo é destruído. Isso não pode ser especificado com o /preview opção. |
/stopat |
Optional. Pode ser usado somente se /keephistory é especificado também. Especifica a versão do arquivo para o arquivo e os arquivos que seguem daí em diante, para o qual o histórico é mantido. A versão padrão de /stopat é a dica (T) para a versão mais recente com check-in de um item. Não é possível usar o rótulo ou o espaço de trabalho versionspec valores para especificar um item para /stopat opção. |
/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 são realmente destruídos. .gif "Observação") Observação
O texto na janela do Prompt de comando exibe a palavra "Destroyed" com cada arquivo que seria destruído.No entanto, o arquivo é realmente 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 for concluído. Se o usuário não especificar /startcleanup, o processo de limpeza de conteúdo destruído ocorre quando a manutenção de banco de dados limpa todos os arquivos que não são referenciados por Visual Studio 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. |
/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 senha para autenticar o usuário com Team Foundation Server. |
/collection |
Especifica a coleção de projeto de equipe. |
Comentários
Quando você usa tf destroy para controle de versão de destruir arquivos, a camada de aplicativo de Team Foundation Server recebe a solicitação de destruir e verificações para ver se você é um membro da Os administradores do Team Foundation o grupo 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, acontece na próxima vez que o conteúdo que não tenha mais referenciado por Team Foundation Server é limpo ativo. \ Você também pode especificar o /startcleanup opção para limpar os arquivos imediatamente após a tf destroy é executado.
Se você executar o tf destroy sem especificar /i e /preview, o sistema exibe um console Yes ou No pedir a cada filespec valor. Caso contrário, você pode especificar Yes to all. Se você não especificar /keephistory, você é solicitado por um texto interativo que avisa sobre pendentes alterações, se existirem. O texto interativo aponta para /preview se você quiser obter mais informações sobre as alterações. Se você especificar /keephistory, também será solicitado por Yes, No, ou All de texto. Se você selecionar Yes ou All, do início do processo de destruição e os caminhos do servidor aos itens destruídos aparecem na janela do Prompt de comando.
Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...
Se você tiver especificado o versionspec o valor como uma dica, os caminhos de servidor exibidos na janela do Prompt de comando incluem a exclusão de IDs. Por exemplo, X 123 podem aparecer na janela do Prompt de comando.
Se você usar o /preview opção, os arquivos não são destruídos, mas o texto de linha de comando exibe os arquivos que seriam destruídos. Por exemplo, se, na linha de comando, digitar tf destroy /preview $/Test1/MyProject/MyProject/Program.cs, a janela de comando exibe este texto:
Destruído: $/Test1/myproject/myproject/Program.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 encontrar o tf o utilitário de linha de comando, consulte Comandos do utilitário de linha de comando do TF.
Efeitos de /keephistory de outras operações de controle de versão
Se você especificar o /keephistory destruído de opção para manter o histórico de arquivos, os arquivos são tratados como destruído pelo seguinte Controle de versão do Team Foundation operações:
Alterar conteúdo se você tentar alterar o conteúdo de um arquivo destruído, por exemplo, editar ou filiais, o sistema emitirá uma mensagem de erro informando que o conteúdo foi destruído.
Branch, mesclar ou unshelve se você tentar branch, mesclar ou unshelve items destruídos, o sistema emitirá uma mensagem de erro informando que o conteúdo dos itens foi destruído.
Destruindo anteriormente itens excluídos
Se um item já tiver sido excluído, uma ID de exclusão é anexada a ele e resulta em uma alteração de nome de arquivo.
Examples
Description
O exemplo a seguir exclui permanentemente o arquivo a.cs.
Code
C:\pi\ws1>tf destroy $/proj/pi/a.cs
Description
O exemplo a seguir exclui uma pasta, aFolder, tipo de linha de comando:
Code
C:\tf delete $/MyTeamProject/aFolder
Description
Para destruir um item excluído, aFolder, você deve digitar na linha de comando:
Code
tf destroy $/MyTeamProject/sFolder;x123
Onde x 123 é a identificação de exclusão.
Consulte também
Tarefas
Destruir a versão controlada de arquivos
Conceitos
Operações disponíveis apenas a partir da linha de comando (Team Foundation Version Control)