Condividi tramite


Comando Destroy (controllo della versione di Team Foundation)

Utilizzare il comando tf destroy per rimuovere o eliminare in modo permanente i file inclusi nel controllo della versione da Controllo della versione di Team Foundation.

Non è possibile ripristinare l'azione di rimozione. Non rimuovere i file ancora necessari. Qualche volta è necessario pulire sistemi di controllo della versione. Se ad esempio alcuni file contengono un virus, è necessario rimuoverli in maniera permanente dal controllo della versione.

Prima di eseguire tf destroy senza l'opzione /keephistory, è consigliabile eliminare innanzitutto i file che si desidera rimuovere in modo permanente. Per ulteriori informazioni, vedere Eliminare file e cartelle dal controllo della versione.

Dopo avere eliminato i file, è possibile sincronizzare il warehouse di Team Foundation. In caso contrario, il warehouse non verrà sincronizzato con gli elementi eliminati in modo permanente.

Autorizzazioni necessarie

Per utilizzare il comando destroy, è necessario essere membro del gruppo di sicurezza Administrators di Team Foundation. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.

tf destroy [/keephistory] <itemspec1>[;<versionspec>][<itemspec2>...<itemspecN>] 
[/stopat:<versionspec>] [/preview] [/startcleanup] [/noprompt] [/silent] [/login:username,[password]] [/collection:TeamProjectCollectionUrl]]

Parametri

Argomento

Oggetto di descrizione

itemspec1 [itemspec2…itemspecN]

Indica il percorso sul server del file o della cartella da rimuovere. Utilizzare più valori itemspec per eliminare più elementi. Ad esempio tf destroy $/TeamProject1 $/teamProject2 $/TeamProject3.

I percorsi locali non sono supportati.

versionspec

Fornisce una versione ad esempio C58 per le opzioni /keephistory o /stopat. I valori consentiti sono relativi alla data, a un consiglio o a un insieme di modifiche specifico. Per ulteriori informazioni sul tipo di analisi eseguito da Team Foundation sulla specifica di una versione per determinare gli elementi all'interno dell'ambito, vedere Sintassi della riga di comando (controllo della versione).

username

Fornisce un valore all'opzione /login. È possibile specificare un valore username come DOMINIO\NomeUtente o NomeUtente.

TeamProjectCollectionUrl

URL dell'insieme di progetti team contenente file che si desidera eliminare (ad esempio, http://myserver:8080/tfs/DefaultCollection).

Opzione

Oggetto di descrizione

/keephistory

Facoltativo. Specifica che la cronologia di un file viene mantenuta proprio come il relativo contenuto viene rimosso. Non è possibile utilizzare questa opzione con l'opzione /preview.

/stopat

Facoltativo. Questa opzione può essere utilizzata solo se è specificata anche l'opzione /keephistory.

Specifica la versione per il file e i file successivi per i quali viene mantenuta la cronologia.

La versione predefinita per /stopat è suggerimento (T) per l'ultima versione archiviata di un elemento.

Non è possibile utilizzare valori versionspec di etichetta o area di lavoro per specificare un elemento per l'opzione /stopat.

/preview

Visualizzazioni nella finestra del prompt dei comandi dei file che vengono rimossi. Quando tf destroy viene eseguito in modalità anteprima, i file non vengono effettivamente rimossi.

NotaNota
Il testo nella finestra del prompt dei comandi visualizza la parola "Eliminato definitivamente" per ogni file che vengono rimossi.Il file non viene tuttavia eliminato in modo permanente quando si utilizza l'opzione /preview.

/startcleanup

Forza l'avvio del processo di pulizia del contenuto del file al termine dell'eliminazione del contenuto. Se l'utente non specifica /startcleanup, il processo di pulizia del contenuto rimosso si verifica quando la manutenzione del database ripulisce tutti i file ai quali Visual Studio Team Foundation Server non fa più riferimento. Per impostazione predefinita, la pulizia è pianificata per essere eseguita una volta al giorno.

/noprompt

/i

Specifica che la rimozione dei file è di tipo non interattivo. /i è un alias per /noprompt.

/silent

Consente di specificare che, quando si eliminano file o cartelle, l'output non verrà scritto nella finestra del prompt dei comandi.

/login

Consente di specificare il nome utente e la password necessari per autenticare l'utente con Team Foundation Server.

/collection

Specifica l'insieme di progetti team.

Note

Quando si utilizza tf destroy per eliminare in modo permanente i file del controllo della versione, il livello applicazione di Team Foundation Server riceve la richiesta di rimozione e verifica che il richiedente sia membro del gruppo di sicurezza Administrators di Team Foundation. Se il richiedente non è un membro del gruppo specificato, viene visualizzata una finestra di errore che indica che non si dispone delle autorizzazioni sufficienti per eseguire l'operazione.

Dopo che il sistema verifica le autorizzazioni, viene eseguito il comando destroy. Questo comando elimina tutti i riferimenti ai file, le aree di sospensione e le modifiche in sospeso. La rimozione effettiva dei file, ovvero l'eliminazione permanente, si verificherà la prossima volta che viene pulito il contenuto al quale Team Foundation Server non fa più riferimento. È anche possibile specificare l'opzione /startcleanup per effettuare la pulizia dei file subito dopo l'esecuzione di tf destroy.

Se si esegue tf destroy senza specificare /i e /preview, viene visualizzata una richiesta Yes o No della console per ogni valore filespec. Altrimenti è possibile specificare Yes to all. Se non si specifica /keephistory, verrà visualizzato un testo interattivo che indica le eventuali modifiche in sospeso. Il testo interattivo punta a /preview che contiene ulteriori informazioni sulle modifiche. Se si specifica /keephistory, sarà necessario scegliere Yes, No o All. Se si seleziona Yes o All, verrà avviato il processo di rimozione e i percorsi server degli elementi rimossi vengono visualizzati nella finestra del prompt dei comandi.

Destroyed: <serverItem1>
Destroyed: <serverItem2>
Destroyed: ...

Se si è specificato il valore versionspec come suggerimento, i percorsi server visualizzati nella finestra del prompt dei comandi includono gli ID di eliminazione. Nella finestra del prompt dei comandi può ad esempio venire visualizzato X123.

Se si utilizza l'opzione /preview, i file non vengono eliminati in modo permanente, ma nel testo della riga di comando vengono visualizzati i file che verrebbero rimossi. Se ad esempio nella riga di comando si digita tf destroy /preview $/Test1/MyProject/MyProject/Program.cs, nella finestra di comando viene visualizzato il testo seguente:

Eliminato in modo permanente: $/Test1/MyProject/MyProject/Program.cs

Il file non viene tuttavia eliminato in modo permanente perché è stata utilizzata l'opzione /preview.

Per ulteriori informazioni su come accedere all'utilità della riga di comando tf, vedere Comandi dell'utilità della riga di comando Tf.

Effetti di /keephistory su altre operazioni di controllo della versione

Se si specifica l'opzione /keephistory per mantenere la cronologia di file rimossi, questi verranno considerati come eliminati in maniera permanente dalle seguenti operazioni Controllo della versione di Team Foundation:

  • Cambia contenuto Se si tenta di modificare il contenuto di un file rimosso, ad esempio modifica o creazione di un ramo, verrà visualizzato un messaggio di errore che indica che il contenuto è stato eliminato in modo permanente.

  • Crea un ramo, unisci o riprendi Se si tenta di unire o riprendere gli elementi rimossi o di crearne un ramo, verrà visualizzato un messaggio di errore che indica che il contenuto degli elementi è stato eliminato in modo permanente.

Distruzione di elementi eliminati in precedenza

Se un elemento è già stato eliminato, il relativo nome del file viene modificato a causa dell'aggiunta dell'ID di eliminazione.

Esempi

Oggetto di descrizione

Nell'esempio seguente viene eliminato in modo permanente il file a.cs.

Codice

C:\pi\ws1>tf destroy $/proj/pi/a.cs

Oggetto di descrizione

Nell'esempio seguente viene eliminata una cartella, aFolder, digitare il codice seguente nella riga di comando:

Codice

C:\tf delete $/MyTeamProject/aFolder

Oggetto di descrizione

Per rimuovere l'elemento eliminato, aFolder, è necessario il seguente codice alla riga di comando:

Codice

tf destroy $/MyTeamProject/sFolder;x123

Dove x123 è l'ID di eliminazione.

Vedere anche

Attività

Eliminare in modo permanente file inclusi nel controllo della versione

Concetti

Operazioni disponibili solo dalla riga di comando (controllo della versione di Team Foundation)

Altre risorse

Comandi dell'utilità della riga di comando Tf