Partilhar via


Destruir o comando (Team Foundation Build)

Você pode usar o TFSBuild destroy comando permanentemente destruir compilações concluídas. Destruindo obsoletas compilações concluídas, você pode economizar espaço no data warehouse.

Aviso

Use esse comando com cuidado porque não é possível reverter a sua ação.

Este comando exclui permanentemente o registro do banco de dados para uma compilação mas artefatos de compilação não relacionados, como, por exemplo, descartes, rótulos de controle de versão e os resultados de teste. Você pode usar o TFSBuild delete comando para excluir os artefatos antes de destruir permanentemente a compilação.

Permissões necessárias

Para usar o destroy de comando, você deve ter o Destruir constrói permissão definida Permitir. Automaticamente, essa permissão é dada para administradores de conjunto de projeto de equipe, os administradores de projeto e construtores. For more information, see Permissões de Team Foundation Server.

TFSBuild destroy /collection:TeamProjectCollectionUrl /BuildDefinition:DefinitionSpec BuildNumber [BuildNumber...] [/noprompt] [/silent] [/preview] 

TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]

TFSBuild destroy TeamProjectCollectionUrl TeamProject BuildNumber [BuildNumber...]

TFSBuild destroy /collection:TeamProjectCollectionUrl /DateRange: [Date]~[Date] /BuildDefinition:DefinitionSpec

TFSBuild destroy /collection:TeamProjectCollectionUrl BuildUri [BuildUri...]

Parâmetros

Argument

Description

TeamProjectCollectionUrl

A URL da coleção de projeto de equipe que contém a compilação que você deseja destruir (por exemplo, http://myserver:8080/tfs/DefaultCollection).

DefinitionSpec

Usado com /BuildDefinition. As definições de compilação que você deseja destruir. Você pode usar caracteres curinga.

BuildNumber

Uma lista separada por espaços da compilação ou compilações que deseja destruir. Se o número de compilação tiver espaços, coloque o número de aspas simples. Você pode usar caracteres curinga.

BuildUri

Uma lista separada por espaço dos URIs das compilações que deseja destruir.

TeamProject

O nome de projeto de equipe para o qual a definição de compilação existe.

Date

Usado para o /daterange opção. Uma data em qualquer formato que o .NET Framework pode parse. Você pode especificar intervalos de datas usando "~" como mostram os exemplos a seguir:

  • ~1/1/2010 – todas as versões que foram criados antes de 1/1/2010

  • 1/1/2010 ~ – todas as compilações que foram criadas após 1/1/2010

  • 1/1/2009 ~ 31/12/2009 – todas as compilações que foram criados entre 1/1/2009 e 31/12/2009

Option

Description

/collection

Especifica a coleção de projeto de equipe.

/BuildDefinition

Especifica a definição de compilação ou definições que você deseja excluir.

/preview

Exibe a janela do Prompt de comando compilações que seriam destruídas. Quando você especificar esta opção, compilações, na verdade, não serão destruídas.

/noprompt

Especifica a não solicitará a você quando você exclui uma compilação.

/silent

Especifica a não gravar a saída para a janela do Prompt de comando enquanto compilações são excluídas. Implica /noprompt.

Comentários

Se você tentar destruir uma compilação sem a permissão apropriada, uma caixa de diálogo informa você de fato.

Exemplo

O exemplo a seguir destrói permanentemente a compilações anteriores à 20 de novembro de 2010, e que são baseados em "Noturna construir" Criar definição de "Works novo" projeto de equipe.

>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20

Consulte também

Tarefas

Excluir uma compilação concluída

Criar uma definição de compilação básico

Outros recursos

Equipe Foundation Compilar Comandos de

Compilações de execução e monitoramento

Criar e trabalhar com definições de compilação