Comando Collection
È possibile utilizzare il comando Collection per connettere, disconnettere o eliminare un insieme di progetti team da una distribuzione di Visual Studio Team Foundation Server. È anche possibile utilizzare il comando Collection per duplicare il database di un insieme esistente, rinominarlo e connetterlo alla distribuzione. Questo processo viene talvolta detto clonazione di un insieme. Tuttavia, non è possibile utilizzare il comando Collection per creare un insieme di progetti team. Per ulteriori informazioni, vedere Creare un insieme di progetti team.
Per gestire in modo interattivo gli insiemi o per creare un insieme è possibile utilizzare il nodo Insiemi di progetti team della console di amministrazione di Team Foundation. Per ulteriori informazioni, vedere Aprire la console di amministrazione di Team Foundation e Organizzazione del server con insiemi di progetti team.
Autorizzazioni necessarie
Per utilizzare il comando Collections è necessario appartenere ai gruppi seguenti:
gruppi di sicurezza Amministratori di Team Foundation e Amministratori nel server o nei server che eseguono la console di amministrazione di Team Foundation
gruppo sysadmin dei server che eseguono l'istanza di SQL Server che ospita i database di Team Foundation Server
il gruppo Amministratori farm della farm da cui si sta eliminando la raccolta siti, se la distribuzione utilizza Prodotti SharePoint e si utilizza l'opzione /delete.
Per ulteriori informazioni, vedere Autorizzazioni per Team Foundation Server.
Nota
Anche se si accede con credenziali amministrative, è necessario aprire una finestra del prompt dei comandi con privilegi elevati per eseguire questa funzione in 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, vedere questa pagina nel sito Web Microsoft: Controllo dell'account utente.
TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]
Parametri
Placeholder |
Oggetto di descrizione |
|---|---|
CollectionName |
Specifica il nome dell'insieme di progetti team. Se il nome dell'insieme contiene spazi è necessario racchiudere il nome tra virgolette (ad esempio, "Insieme"). |
ServerName |
Specifica il nome del server che ospita il database di configurazione di Team Foundation Server e, se si desidera utilizzare un'istanza diversa da quella predefinita, il nome dell'istanza. Se si specifica un'istanza, è necessario utilizzare il seguente formato: ServerName\InstanceName |
DatabaseName |
Specifica il nome del database di configurazione. Per impostazione predefinita, il nome di questo database è TFS_ConfigurationDB. |
Opzione |
Oggetto di descrizione |
|---|---|
/attach |
Obbligatorio se non si utilizza né /detach né /delete. Se si specifica questa opzione occorre utilizzare anche l'opzione /collectionDB. In alternativa è anche possibile utilizzare /collectionName e /clone con questa opzione. Se si utilizza l'opzione /attach, il database dell'insieme specificato verrà aggiunto alla distribuzione di Team Foundation Server. |
/detach |
Obbligatorio se non si utilizza né /attach né /delete. Se si specifica questa opzione occorre utilizzare anche l'opzione /collectionName. Se si utilizza l'opzione /detach, il database dell'insieme specificato verrà arrestato e l'insieme verrà disconnesso dalla distribuzione di Team Foundation Server. |
/delete |
Obbligatorio se non si utilizza né /detach né /attach. Se si specifica questa opzione occorre utilizzare anche l'opzione /collectionName. Se si utilizza l'opzione /delete, il database dell'insieme specificato verrà arrestato e l'insieme verrà disconnesso in modo permanente da Team Foundation Server. Non si sarà in grado di riconnettere il database dell'insieme a questa o qualsiasi altra distribuzione. |
/CollectionName:CollectionName |
Obbligatorio se viene utilizzato /detach oppure /delete. Se utilizzata con /detach o /delete, questa opzione specifica l'insieme che verrà disconnesso o eliminato. Se si utilizza questa opzione con /attach, specifica un nuovo nome per l'insieme. Se utilizzata sia con /attach sia con /clone, questa opzione specifica il nome dell'insieme duplicato. |
/CollectionDB:ServerName;DatabaseName |
Obbligatorio se viene utilizzato /attach. Questa opzione specifica il nome del server che esegue SQL Server e il nome del database dell'insieme ospitato in tale server. |
/clone |
Se si specifica questa opzione, il database dell'insieme verrà duplicato in SQL Server e il database duplicato verrà connesso a Team Foundation Server. Nella maggior parte dei casi questa opzione viene utilizzata nel processo di suddivisione di un insieme di progetti team. |
Esempio
Nell'esempio seguente viene mostrato come rimuovere in modo permanente l'insieme di progetti team "Contoso Summer Intern Projects" da una distribuzione di Team Foundation Server.
Nota
Ogni riferimento a società, organizzazioni, prodotti, nomi di domini, indirizzi di posta elettronica, logo, persone, luoghi ed eventi citati nel presente documento è puramente casuale e ha il solo scopo di illustrare l'uso del prodotto Microsoft.
TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"
Nell'esempio seguente viene mostrato come duplicare l'insieme di progetti team "Contoso Summer Interns Projects", come denominarlo "Contoso Winter Interns Projects" e come allegare l'insieme duplicato alla distribuzione di Team Foundation Server.
TFSConfig Collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects" /CollectionName:"Contoso Winter Intern Projects" /clone
Vedere anche
Attività
Spostare un insieme di progetti team
Dividere un insieme di progetti team
Concetti
Backup e ripristino della distribuzione