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. .gif "Nota") Nota
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)