TFSDeleteProject: eliminazione di progetti team

  • Articolo

È inoltre possibile rimuovere un progetto team da Team Foundation Server quando per il progetto non è più necessario utilizzare TFSDeleteProject. Inoltre, se ci sono componenti che rimangono non eliminati dopo una creazione del progetto team non riuscita, è possibile utilizzare TFSDeleteProject per rimuoverli.

Nota importanteImportante

Quando si esegue TFSDeleteProject, distrugge in modo permanente il progetto team, che non può essere successivamente recuperato. È necessario eseguire il backup di tutti i dati importanti del progetto prima di utilizzare TFSDeleteProject.

Lo strumento della riga di comando TFSDeleteProject è disponibile in Unità:\Programmi\Microsoft Visual Studio 10.0\Common7\IDE su qualsiasi computer client su cui è possibile eseguire Team Explorer. 

Nota

Anche se si accede con autorizzazioni amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione su un server che esegue Windows Server 2008. Per aprire una finestra del prompt dei comandi con privilegi elevati, fare clic Start, fare clic con il pulsante destro del mouse su Prompt dei comandi, quindi scegliere Esegui come amministratore. Per ulteriori informazioni, visitare il sito Web Microsoft Controllo dell'account utente.

Autorizzazioni necessarie

Per utilizzare il comando TFSDeleteProject, è necessario essere un membro del gruppo di sicurezza Administrators di Team Foundation o Project Administrators. Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server e Gruppi predefiniti, autorizzazioni e ruoli di Team Foundation Server.

TFSDeleteproject [/q] [/force] [/excludewss] /collection:URL TeamProjectName

Parametri

Opzione

Oggetto di descrizione

/q

Facoltativo. Viene utilizzata la modalità non interattiva. Non richiedere la conferma all'utente.

/force

Facoltativo. Specifica che il processo di eliminazione deve continuare anche se non è possibile eliminare alcuni componenti.

/excludewss

Facoltativo. Specifica di non cancellare il sito SharePoint associato al progetto team. Specificare questa opzione per gestire il sito esistente in modo che gli altri progetti team possono continuare ad utilizzarlo.

/collection:URL

Obbligatoria. Specifica l'URI dell'insieme di progetti team. È necessario utilizzare il seguente formato per l'URI: http://NomeServer:Porta/NomeDirectoryVirtuale/NomeInsieme

Se non si specifica che viene utilizzata una directory virtuale, è necessario utilizzare il formato seguente per l'URI:

http://NomeServer:Porta/NomeInsieme.

TeamProjectName

Obbligatoria. Il nome del progetto. Se il nome include spazi, racchiuderlo tra virgolette.

Note

Quando si crea un progetto team, Team Foundation Server crea oggetti dati sul server che ospita Team Foundation Server e può creare oggetti dati sul server che ospita Prodotti SharePoint e il server che ospita SQL Server Reporting Services. Quando si rimuove un progetto team, i rapporti vengono rimossi automaticamente da SQL Server Reporting Services.

Quando si rimuove un progetto team, è possibile scegliere se rimuovere o meno gli oggetti creati per supportare il sito di SharePoint. Tuttavia, un errore può impedire Team Foundation Server di creare o eliminare tutti gli oggetti. Per risolvere questi problemi, nelle seguenti sezioni vengono fornite informazioni complementari, collegamenti ad altre risorse e passaggi specifici che consentono di determinare la causa del problema, correggere il problema e quando necessario eliminare oggetti dati che rimangono dopo avere eseguito TFSDeleteProject.

  • Processo TFSDeleteProject

  • Dati che potrebbero rimanere non eliminati

  • Verificare che vengano eliminati i componenti del progetto team

  • Rimuovere componenti rimanenti dopo eliminazione del progetto parziale

  • Aumenta il periodo di timeout.

Processo TFSDeleteProject

Quando si utilizza lo strumento da riga di comando TFSDeleteProject, prima elimina i dati del progetto e quindi i siti Web del progetto.

Fase 1: TFSDeleteProject elimina i dati del progetto

Nella prima fase, TFSDeleteProject esegue automaticamente i passaggi seguenti per rimuovere i dati del progetto team:

  1. TFSDeleteProject crea un inventario di tutti i componenti che sono candidati per l'eliminazione. Ciò include i componenti che si integrano con Test Manager, Team Foundation Build e Controllo della versione di Team Foundation.

  2. TFSDeleteProject elimina il componente che visualizza il nodo di progetto in Team Explorer.

  3. TFSDeleteProject contrassegna le informazioni sul controllo della versione per l'eliminazione, ma non elimina immediatamente tali informazioni. Le informazioni includono tutti i rami del controllo della versione nel progetto specificato, ma nessun altro ramo al di fuori del progetto.

    • Se un ramo padre e un ramo figlio sono entrambi nel progetto, TFSDeleteProject contrassegna entrambi per l'eliminazione.

    • Se i rami padre e figlio sono in progetti diversi, TFSDeleteProject contrassegna solo il ramo specificato.

    • Se un altro progetto è un ramo dal progetto specificato, TFSDeleteProject contrassegna solo il progetto specificato. Quando viene eliminato il progetto specificato, il progetto di ramo diventa un orfano.

  4. TFSDeleteProject elimina immediatamente i dati di compilazione, includendo le informazioni e i dati principali, le definizioni di compilazione, gli agenti di compilazione e risultati del test associati al progetto team. Lo strumento non elimina destinazioni finali di compilazione. Non è necessario eliminare la destinazione finale di compilazione di un progetto team obsoleto prima di creare un progetto team che utilizza la stessa destinazione finale di compilazione.

    Se il progetto specificato contiene una grande quantità di dati di compilazione, l'eliminazione potrebbe non terminare entro il periodo di timeout. Per risolvere questo problema, vedere Aumenta il periodo di timeout, quindi eseguire nuovamente TFSDeleteProject.

  5. TFSDeleteProject elimina immediatamente gli elementi di lavoro e i campi elemento di lavoro che appartengono al progetto specificato ed elimina tutti i metadati non condivisi.

    Se il progetto specificato contiene una grande quantità di elementi di lavoro, l'eliminazione potrebbe non terminare entro il periodo di timeout. Per risolvere questo problema, vedere Aumenta il periodo di timeout, quindi eseguire nuovamente TFSDeleteProject.

Fase 2: TFSDeleteProject elimina i siti Web del progetto

Nella seconda fase, TFSDeleteProject elimina i seguenti dati:

Nota importanteImportante

È possibile che il completamento di tali passaggi richieda tempi particolarmente lunghi durante i quali potrebbe verificarsi una riduzione delle prestazioni del server.

  • TFSDeleteProject Utilizza Reporting Services API per eliminare i rapporti sul server che ospita Reporting Services.

  • TFSDeleteProject Elimina il sito Web del portale del progetto dal server che ospita Prodotti SharePoint. Si verifica questo passaggio solo se il progetto possiede il sito e l'eliminazione del sito non è esclusa nella riga di comando. (considerare che più progetti possono puntare a un singolo sito, ma solo uno di loro può essere il proprietario dove i rapporti/dashboard utilizzano questo progetto per impostazione predefinita).

    Nota

    Prima di eliminare un progetto team, è possibile controllare che Reporting Services e Prodotti SharePoint utilizzino gli URL del progetto corretti verificando le impostazioni del portale. Per ulteriori informazioni, vedere Aggiungere un portale del progetto team.

Se TFSDeleteProject elimina correttamente tutti gli elementi dati di cui sopra, restituisce il messaggio Eseguito. Per verificare questo risultato, vedere Verifica che vengano eliminati i componenti del progetto team.

Se uno o più componenti non sono stati rimossi, è possibile eseguire di nuovo TFSProjectDelete tramite l'opzione /force per continuare il processo di eliminazione anche se non è in grado di eliminare tutti gli elementi dati. Con questa opzione TFSDeleteProject, salta un componente che non è possibile eliminare, viene restituito un messaggio di errore, elimina il componente successivo e lascia i metadati del progetto team e le impostazioni di sicurezza invariati.

Dati che potrebbero rimanere non eliminati

I dati seguenti potrebbero rimanere correttamente nella distribuzione dopo che TFSDeleteProject ha terminato correttamente:

  • Dati del progetto team nel cubo. I dati del progetto team rimangono nel cubo fino a che non è stato ricompilato il cubo, ora in cui servizio del controller del warehouse rimuove tutti i dati di compilazione storici eliminati dai database Team Foundation.

  • Compilare file e cartelle a Sola Scrittura. Binari compilati, file di log di compilazione e file di log contenenti i risultati del test vengono pubblicati durante il processo di compilazione. I percorsi per questi file non vengono eliminati. Se si desidera rimuovere tali file, è necessario rimuoverli manualmente.

  • I metadati della gestione degli elementi di lavoro condivisi. TFSDeleteProject non elimina alcuni metadati per la gestione degli elementi di lavoro condivisa tra progetti team.

  • Aree di sospensione del controllo della versione che contengono codice condiviso. Aree di sospensione del controllo della versione non vengono eliminate se il codice nell'area di sospensione proviene da più progetti team.

Verificare eliminazione del progetto

È possibile verificare il successo dell'eliminazione di un progetto confermando che il nodo del progetto team non viene più visualizzato in Team Explorer e che il sito Web del portale del progetto e le cartelle dei rapporti non esistono più.

Per verificare che è stato eliminato un progetto team correttamente

  1. Aprire Team Explorer e verificare che il progetto non sia visualizzato come un nodo di progetto.

  2. Aprire Internet Explorer e digitare l'URL del sito Web del portale del progetto. Verificare che il sito non esista più.

  3. In Internet Explorer e nella casella Indirizzo, digitare l'URL del sito Web Reporting Services utilizzando uno dei seguenti formati di URL:

    • http://ReportingServices/Reports

    • **http://ReportingServices/Reports_**TFSInstance

  4. In Gestione rapporti, fare clic su Mostra dettagli.

  5. Verificare che la cartella per il progetto team eliminato non venga più visualizzata. Fare clic sulla cartella radice TfsReports, quindi selezionare la cartella denominata per l'insieme di progetti. La cartella con il nome del progetto eliminato non dovrebbe essere più disponibile.

  6. Se i rapporti o il sito Web rimane, vedere procedura descritta di seguito.

Rimuovere componenti rimanenti dopo eliminazione del progetto parziale

Se il sito Web del portale del progetto e la cartella dei rapporti rimangono dopo avere eliminato un progetto team, rimuovere manualmente il sito e la cartella.

Per rimuovere manualmente i rapporti e il sito Web del portale del progetto di un progetto team eliminato

  1. Accedere al server che ospita Reporting Services per il progetto team cancellato.

  2. Aprire Internet Explorer e nella casella di indirizzo digitare l'URL del sito Web di Reporting Services utilizzando uno dei seguenti formati di URL:

    • https://localhost/Reports

    • **https://localhost/Reports_**TFSInstance

  3. In Gestione rapporti, fare clic su Mostra dettagli.

  4. Fare clic sulla cartella radice TfsReports, quindi selezionare la cartella denominata per l'insieme di progetti.

  5. Selezionare la casella di controllo per il progetto team cancellato.

  6. Scegliere Elimina.

  7. Fare clic su OK per confermare che si desidera eliminare la cartella dei rapporti per il progetto team.

  8. Per rimuovere il sito Web del portale del progetto di un progetto team eliminato, vedere la seguente pagina sul sito Web Microsoft: Procedura: creare, modificare ed eliminare i siti di Windows SharePoint Services.

Aumenta il periodo di timeout.

Per impostazione predefinita, ogni chiamata del servizio Web che il comando TFSDeleteProject emette per eliminare un componente, deve essere completata entro 10 minuti. Se ci sono sei chiamate, il processo potrebbe impiegare fino a un'ora. Se si desidera eliminare un progetto team associato a una grande quantità di dati, è possibile aumentare temporaneamente questo periodo di timeout.

Nota

Quando si aumenta il periodo di timeout, la modifica influisce su tutte le chiamate del servizio Web. In generale, si desidera mantenere il periodo di timeout entro i 10 minuti per impedire chiamate del servizio Web dal peggioramento delle prestazioni del server che impediscono agli utenti di utilizzare l'interfaccia utente per periodi lunghi di tempo. Pertanto, in seguito all'eliminazione del progetto, è necessario impostare di nuovo il periodo di timeout su 10 minuti.

Autorizzazioni necessarie

Per completare queste procedure è necessario essere un amministratore di Windows nel server a livello applicazione.

Nota importanteImportante

Se si modifica in modo errato il Registro di sistema è possibile che il computer diventi instabile. Se non si ha familiarità con il Registro di sistema, evitare di aggiungere o rimuovere voci o di apportare qualsiasi modifica.

Per aumentare il periodo di timeout per il comando TFSDeleteProject.

  1. Accedere al server di livello applicazione.

  2. Fare clic sul pulsante Start, scegliere Esegui, digitare regedit, quindi scegliere OK.

  3. Nel riquadro del browser, espandere HKEY_ LOCAL_MACHINE:

    • Se il server esegue un sistema operativo a 32 bit, espandere: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings.

    • Se il server esegue un sistema operativo a 64 bit, espandere: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432\Microsoft\VisualStudio\10.0\TeamFoundation\RequestSettings.

  4. Se la chiave TeamFoundation\RequestSettings non esiste, attenersi alla seguente procedura per crearla:

    1. Fare clic con il pulsante destro del mouse su TeamFoundation, puntare a Nuovo, quindi scegliere Chiave.

    2. Assegnare un nome alla chiave RequestSettings.

    3. Fare clic con il pulsante destro del mouse su RequestSettings, puntare a Nuovo e quindi scegliere Valore DWORD.

    4. Assegnare un nome al nuovo valore DefaultTimeout.

  5. Fare clic con il pulsante destro del mouse su DefaultTimeout e scegliere Modifica.

  6. In Dati valore, digitare il periodo di timeout in millisecondi, quindi fare clic su Decimale.

    Ad esempio, per aumentare il periodo di timeout a 30 minuti, digitare 1800000. Per modificare il periodo di timeout di nuovo a 10 minuti, digitare 600000.

  7. quindi fare clic su OK.

  8. Scegliere Esci dal menu File.

Esempio

Nel comando seguente vengono rimossi tutti i componenti associati al progetto team StoreFront sul server Team Foundation Server AdventureWorks1 in un insieme di progetti Collection1 e da Team Explorer.

TFSDeleteProject /force /collection:http://AdventureWorks1:8080/Collection1 StoreFront

Vedere anche

Attività

Connettersi e accedere a progetti team in Team Foundation Server

Creare un progetto Team

Altre risorse

Gestione delle autorizzazioni

Configurazione di risorse per il supporto di progetti team

Utilizzo degli strumenti della riga di comando di Team Foundation Server