Comando Destroy
Aggiornamento: novembre 2007
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 Procedura: 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. Per ulteriori informazioni, vedere Pianificazione della sincronizzazione con il data warehouse.
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]
Parametri
Argomento |
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 (Team System). |
Opzione |
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.
|
||
/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 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. |
.gif "Nota")
Nota: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 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 diramazione, verrà visualizzato un messaggio di errore che indica che il contenuto è stato eliminato in modo permanente.
Dirama, unisci o riprendi Se si tenta di diramare, unire o riprendere gli elementi rimossi, 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
Descrizione
Nell'esempio seguente viene eliminato in modo permanente il file a.cs.
Codice
C:\pi\ws1>tf destroy $/proj/pi/a.cs
Descrizione
Nell'esempio seguente viene eliminata una cartella, aFolder, digitare il codice seguente nella riga di comando:
Codice
C:\tf delete $/MyTeamProject/aFolder
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à
Procedura: eliminare in modo permanente file inclusi nel controllo della versione
Concetti
Operazioni disponibili solo dalla riga di comando (controllo della versione di Team Foundation)