Excluir um comando (Team Foundation Build)
Você pode usar o delete comando para excluir uma compilação concluída, incluindo alguns ou todos os dados relacionados.
Observaçã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:
|
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:
|
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