Comando Delete (Team Foundation Build)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Il comando delete consente di eliminare una determinata compilazione completata. Tutti i dati correlati alla compilazione vengono eliminati dall'agente di compilazione e dal controllo della versione e la destinazione finale viene cancellata. Inoltre la compilazione non viene più visualizzata in Build Explorer.

Autorizzazioni necessarie

Per eseguire il comando delete l'account che richiede l'operazione di eliminazione deve disporre dell'autorizzazione Amministra 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.

Nota:
Anche se l'accesso è stato eseguito con le credenziali amministrative, è necessario aprire un prompt dei comandi con privilegi elevati per eseguire questa funzione in un server con Windows Server 2008 in esecuzione. Per aprire un prompt dei comandi con privilegi elevati, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e fare clic su Esegui come amministratore. Per ulteriori informazioni, vedere il sito Web Microsoft (informazioni in lingua inglese).

Anche se l'accesso è stato eseguito con le credenziali amministrative, è necessario aprire un prompt dei comandi con privilegi elevati per eseguire questa funzione in un server con Windows Server 2008 in esecuzione. Per aprire un prompt dei comandi con privilegi elevati, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi e fare clic su Esegui come amministratore. Per ulteriori informazioni, vedere il sito Web Microsoft (informazioni in lingua inglese).

TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer /builddefinition:definitionSpec buildNumbers…

TFSBuild delete [/noprompt] [/silent] /server:teamFoundationServer buildUris…

TFSBuild delete [/noprompt] [/silent] teamFoundationServer teamProject buildNumbers…

Parametri

Argomento	Descrizione
teamfoundationserver	URL del server Team Foundation utilizzato per le compilazioni.
teamProject	Nome del progetto Team per cui esiste la definizione di compilazione.
definitionSpec	Utilizzata con /builddefinition. Compilazione o compilazioni da eliminare. È supportato l'utilizzo di caratteri jolly.
BuildNumbers	Elenco separato da spazi della compilazione o delle compilazioni da eliminare. Se il numero di compilazione contiene spazi, racchiuderlo tra virgolette singole. È supportato l'utilizzo di caratteri jolly.
buildUris	Elenco separato da spazi degli URI delle compilazioni da eliminare. Ad esempio tfsbuild delete uri1 uri2 uri3 /s:MyServer.

Opzione	Descrizione
/noprompt	Facoltativo. Non viene richiesta conferma per l'eliminazione di una compilazione.
/silent	Facoltativo. Non scrivere output nella finestra del prompt dei comandi durante l'eliminazione. Implica /noprompt.
/server	Server di Team Foundation utilizzato per la compilazione o le compilazioni da eliminare.
/builddefinition	Specifica la definizione o le definizioni di compilazione da eliminare.

Note

Processo di eliminazione

Quando si elimina un numero di compilazione, attenersi alla seguente procedura:

Verificare che il numero di compilazione sia valido e che la compilazione non sia in corso.
Eliminare il contenuto dell'archivio di compilazione e del sito di destinazione se il richiedente dispone dell'autorizzazione Amministra compilazione.
Cancellare la destinazione finale dei file binari dalla compilazione specificata. Se si verifica un errore durante il processo, verrà visualizzato un messaggio di avviso. Ciononostante l'eliminazione verrà considerata come eseguita.

Nota:

Non vengono eliminati dati dal data warehouse.

Nota:
Non vengono eliminati dati dal data warehouse.

Eliminazione di più compilazioni

Se si specificano più compilazioni, un eventuale errore durante l'eliminazione di una di queste non provoca l'interruzione del processo. Il comando continua a eliminare le altre compilazioni dopo che viene visualizzato un messaggio di errore relativo all'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 "TestBuild1 1_20070510.1" e "TestBuild 1_20070510.2" dal progetto Team AdventureWorks su server01.

> > tfsbuild.exe delete http://server01:8080 Adventureworks “TestBuild1 1_20070510.1” “TestBuild 1_20070510.2”

Nell'esempio seguente vengono eliminate due compilazioni specifiche dove definitionSpec è "\Adventureworks\Definition1" del progetto Team AdventureWorks su server01.

>tfsbuild.exe delete /server:http://server01:8080 /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" del progetto Team AdventureWorks su server01.

>tfsbuild.exe delete /server:http://server01:8080 vstfs:///TestBuild/TestBuild/1 vstfs:///TestBuild/TestBuild/29

Vedere anche

Attività

Procedura: eliminare una compilazione completata (riga di comando)

Procedura: creare una definizione di compilazione

Altre risorse

Comandi di Team Foundation Build

Esecuzione delle generazioni in Team Foundation Build

Utilizzo delle definizioni di compilazione in Team Foundation Build

Condividi tramite