Comando Destroy (Team Foundation Build)
È possibile eseguire il comando TFSBuild destroy per eliminare in modo permanente le compilazioni complete. Eliminando le compilazioni complete obsolete, è possibile risparmiare spazio nel data warehouse.
.gif "Nota di avviso") Attenzione |
|---|
Utilizzare questo comando con cautela poiché non è possibile annullarne l'effetto. |
Questo comando consente di eliminare in modo permanente il record di database per una compilazione, ma non elementi correlati alla compilazione, ad esempio rilasci, etichette del controllo della versione e risultati test. È possibile utilizzare il comando TFSBuild delete per eliminare elementi prima che venga eliminata in modo permanente la compilazione.
Autorizzazioni necessarie
Per utilizzare il comando destroy, è necessario disporre dell'autorizzazione Rimuovi compilazioni impostata su Consenti. Questa autorizzazione viene concessa automaticamente agli amministratori dell'insieme di progetti team, agli amministratori di progetto e ai generatori. Per ulteriori informazioni, vedere Autorizzazioni per 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...]
Parametri
Argomento |
Oggetto di descrizione |
|---|---|
TeamProjectCollectionUrl |
URL dell'insieme di progetti team contenente la compilazione che si desidera eliminare (ad esempio, http://myserver:8080/tfs/DefaultCollection). |
DefinitionSpec |
Utilizzata con /BuildDefinition. Le definizioni di compilazione che si desidera eliminare. È possibile utilizzare i caratteri jolly. |
BuildNumber |
Elenco separato da spazi delle compilazioni da eliminare. Se il numero di build contiene spazi, racchiuderlo tra virgolette singole. È possibile utilizzare i caratteri jolly. |
BuildUri |
Elenco separato da spazi degli URI delle compilazioni da eliminare. |
TeamProject |
Nome del progetto Team per cui esiste la definizione di compilazione. |
Date |
Utilizzato per l'opzione /daterange. Una data in un qualunque formato analizzabile da .NET Framework. È possibile specificare gli intervalli di date utilizzando "~" come mostrato negli esempi seguenti:
|
Opzione |
Oggetto di descrizione |
|---|---|
/collection |
Specifica l'insieme di progetti team. |
/BuildDefinition |
Specifica la definizione o le definizioni di compilazione che si desidera eliminare. |
/preview |
Visualizzazioni nella finestra del prompt dei comandi delle compilazioni che vengono rimosse. Quando viene specificata questa opzione, le compilazioni non vengono effettivamente rimosse. |
/noprompt |
Consente di specificare di non chiedere la conferma per l'eliminazione di una compilazione. |
/silent |
Consente di specificare di non scrivere output nella finestra del prompt dei comandi durante l'eliminazione delle compilazioni. Implica /noprompt. |
Note
Se si tenta di eliminare una compilazione senza l'autorizzazione appropriata, viene visualizzata una finestra di dialogo che informa l'utente del problema.
Esempio
Nell'esempio seguente vengono eliminate in modo permanente compilazioni precedenti al 20 novembre 2010 e basate sulla definizione di compilazione "Nightly Build" nel progetto team "New Works".
>tfsbuild.exe destroy /collection: http://myserver:8080/tfs/DefaultCollection /builddefinition:"New Works\Nightly Build" /daterange:~2010-11-20
Vedere anche
Attività
Eliminare una compilazione completata
Creare una definizione di compilazione di base
Altre risorse
Comandi di Team Foundation Build