Comando Delete (Team Foundation Build)
È possibile utilizzare il comando delete per eliminare una compilazione completata, includendo alcuni o tutti i dati correlati.
Nota
Questo comando non elimina i dati dal warehouse; per eseguire questa operazione, utilizzare il comando destroy. Per ulteriori informazioni, vedere Comando Destroy (Team Foundation Build).
Autorizzazioni necessarie
Per eseguire il comando delete l'account che richiede l'operazione di eliminazione deve disporre dell'autorizzazione Elimina compilazione impostata su Consenti. Se alla compilazione eliminata sono associati risultati di test, l'account deve disporre dell'autorizzazione Pubblica risultati test impostata su Consenti. Inoltre, l'account del servizio di livello applicazione e l'account del servizio di Team Foundation Build devono disporre delle autorizzazioni di lettura/scrittura per la destinazione finale della compilazione. Per ulteriori informazioni, vedere Autorizzazioni per 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
Parametri
Argomento |
Oggetto di descrizione |
|---|---|
teamProject |
Nome del progetto Team per cui esiste la definizione di compilazione. |
definitionSpec |
Utilizzata con /builddefinition. Compilazione o compilazioni che si desidera eliminare. È supportato l'utilizzo di caratteri jolly. |
buildNumber |
Elenco separato da spazi delle compilazioni da eliminare. Se il numero di build contiene spazi, racchiuderlo tra virgolette singole. È supportato l'utilizzo di caratteri jolly. |
buildUri |
Elenco separato da spazi degli URI delle compilazioni da eliminare. |
teamProjectCollectionUrl |
URL dell'insieme di progetti team contenente la compilazione che si desidera eliminare (ad esempio, http://myserver:8080/tfs/DefaultCollection). |
deleteOptions |
Il valore fornito dall'utente per l'opzione /deleteOptions. Per eliminare una compilazione, è possibile specificare una o più delle opzioni riportate:
|
date |
Valore fornito dall'utente per l'opzione /daterange. È possibile specificare gli intervalli di date utilizzando "~" come mostrato negli esempi seguenti:
|
.gif "Nota")
Nota
Opzione |
Oggetto di descrizione |
|---|---|
/noprompt |
Non richiedere conferma per l'eliminazione di una compilazione. |
/silent |
Non scrivere output nella finestra del prompt dei comandi durante l'eliminazione. Implica /noprompt. |
/builddefinition |
Specifica la definizione o le definizioni di compilazione che si desidera eliminare. |
/collection |
Specifica l'insieme di progetti team. |
/deleteOptions |
Consente di specificare le opzioni per l'eliminazione di una compilazione. |
/preview |
Visualizza ciò che si sarebbe verificato senza l'esecuzione dell'operazione delete. |
/daterange |
Consente di specificare l'intervallo di date delle compilazioni da eliminare. |
Note
Processo di eliminazione
Se si verifica un errore durante il processo, viene visualizzato un messaggio di avviso. L'eliminazione verrà considerata come eseguita anche se viene visualizzato un messaggio di avviso.
Eliminazione di più compilazioni
Se si specificano più compilazioni, un errore nell'eliminazione di una delle compilazioni non interromperà il processo. Il comando continua a eliminare le altre compilazioni dopo avere visualizzato un messaggio di errore per l'eliminazione della compilazione.
Log eventi
Le eliminazioni di compilazioni vengono registrate nel log eventi Il log eventi include informazioni sull'utente che ha eliminato la compilazione, compresi la data e l'ora e il numero.
Esempio
Nell'esempio seguente vengono eliminate due compilazioni definite dai numeri di build "TestBuild1 1_20070510.1" e "TestBuild 1_20070510.2" dal progetto team AdventureWorks nell'insieme di progetti team all'indirizzo http://myserver:8080/tfs/DefaultCollection.
> > tfsbuild.exe delete http://myserver:8080/tfs/DefaultCollection Adventureworks "TestBuild1 1_20070510.1" "TestBuild 1_20070510.2"
Nell'esempio seguente vengono eliminate due compilazioni specifiche in cui definitionSpec è "\Adventureworks\Definition1" dal progetto team AdventureWorks nell'insieme di progetti team all'indirizzo 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"
Nell'esempio seguente vengono eliminate due compilazioni definite dagli URI "vstfs:///TestBuild/TestBuild/1" e "vstfs:///TestBuild/TestBuild/2" dal progetto team AdventureWorks nell'insieme di progetti team all'indirizzo http://myserver:8080/tfs/DefaultCollection.
>tfsbuild.exe delete /collection:http://myserver:8080/tfs/DefaultCollection vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29
Vedere anche
Attività
Eliminare una compilazione completata