Excluir um comando (Team Foundation Build)

  • Artigo

Você pode usar o delete comando para excluir uma compilação concluída, incluindo alguns ou todos os dados relacionados.

ObservaçãoObservação

Este comando não exclui os dados do depósito; para realizar esse tipo de operação, use o destroy comando. For more information, see Destruir o comando (Team Foundation Build).

Permissões necessárias

Para executar o delete de comando, a conta solicitando a operação de exclusão deve ter o Delete constrói permissão definida Permitir. Se a compilação é excluída tiver os resultados do teste associados a ele, a conta deve ter o publicar resultados de teste permissão definida Permitir. Além disso, a conta de serviço de camada de aplicativo e o Team Foundation Build a conta de serviço deve ter permissões de leitura/gravação para o local de soltar de compilação. For more information, see Permissões de Team Foundation Server.

TFSBuild delete /collection:teamProjectCollectionUrl /builddefinition:definitionSpec buildnumber[buildNumber...] [/deleteOptions:deleteOptions] [/noprompt] [/silent] [/preview] 

TFSBuild delete /collection:teamProjectCollectionUrl buildUri[buildUri...]

TFSBuild delete teamProjectCollectionUrl teamProject buildNumber[buildNumber...]

TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] /buildDefinition:definitionSpec

TFSBuild delete /collection:teamProjectCollectionUrl /dateRange:[date]~[date] teamProject

Parâmetros

Argument

Description

teamProject

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

definitionSpec

Usado com /builddefinition. A compilação ou compilações que você deseja excluir. Suporte para caracteres curinga.

buildNumber

Uma lista separada por espaços da compilação ou compilações que você deseja excluir. Se o número de compilação tiver espaços, coloque o número de aspas simples. Suporte para caracteres curinga.

buildUri

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

teamProjectCollectionUrl

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

deleteOptions

O valor que o usuário fornece para o /deleteOptions opção. Para excluir uma compilação, você pode especificar um ou mais das seguintes opções:

  • DropLocation – exclui o local de destino da compilação.

  • TestResults – exclui os resultados do teste para a compilação.

  • Rótulo – exclui a versão do controle rótulo foi criado por compilação.

  • Detalhes – exclui os detalhes (por exemplo, o log de atividade) das compilações.

  • Símbolos – exclui qualquer arquivo de símbolo (*.pdb) no armazenamento de símbolo que está associado com a compilação.

  • Todos – exclui todos os dados que está associados com a compilação.

    ObservaçãoObservação
    Você pode separar as opções usando vírgulas.Por exemplo, você pode excluir o descarte e símbolos de uma compilação usando "/deleteOptions: DropLocation, Symbols".

date

O valor de usuário fornecido para o /daterange opção. 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

/noprompt

Não avisar quando você exclui uma compilação.

/silent

Não grave saída da janela do Prompt de comando durante a exclusão. Implica /noprompt.

/builddefinition

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

/collection

Especifica a coleção de projeto de equipe.

/deleteOptions

Especifica as opções para excluir uma compilação.

/preview

Exibe o que ocorreria, sem realmente executar o delete operação.

/daterange

Especifica o intervalo de datas das compilações que você deseja excluir.

Comentários

Processo de exclusão

Se ocorrer uma falha durante esse processo, aparece uma mensagem de aviso. No entanto, mesmo se um aviso será exibido, a exclusão é considerada bem-sucedido.

Várias compilações sendo excluídas.

Se você especificar várias compilações, uma falha ao excluir um das compilações não interrompa o processo. O comando continua excluir as outras criações depois de fornecer uma mensagem de erro de falha de exclusão de compilação.

Log de eventos

Construir as exclusões são registradas no log de eventos. O log terá informações sobre quem excluído a compilação, a hora em que a compilação foi excluída e o número de compilação.

Exemplo

O exemplo a seguir exclui duas compilações definidas pela compilação números "TestBuild1 1_20070510.1" e "testbuild 1_20070510.2" do projeto de equipe AdventureWorks na coleção de projeto de equipe em http://myserver:8080/tfs/DefaultCollection.

> > tfsbuild.exe delete http://myserver:8080/tfs/DefaultCollection Adventureworks "TestBuild1 1_20070510.1" "TestBuild 1_20070510.2"

A seguir exclui duas específica da exemplo baseia-se onde o definitionSpec é "\Adventureworks\Definition1" do projeto de equipe AdventureWorks na coleção de projeto de equipe em http://myserver:8080/tfs/DefaultCollection.

>tfsbuild.exe delete /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"\Adventureworks\Definition 1" "Definition 1_20070510.1" "Definition 1_20070510.2"

O exemplo a seguir exclui duas compilações definidas pela compilação URIs "vstfs: / / / TestBuild/TestBuild/1" e "vstfs: / / / TestBuild/TestBuild/2" do projeto de equipe AdventureWorks na coleção de projeto de equipe em http://myserver:8080/tfs/DefaultCollection.

>tfsbuild.exe delete /collection:http://myserver:8080/tfs/DefaultCollection vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29

Consulte também

Tarefas

Excluir uma compilação concluída

Outros recursos

Destruir o comando (Team Foundation Build)