Comando Collection
È possibile utilizzare il comando Collection per connettere, disconnettere o eliminare una raccolta di progetti team da una distribuzione di Visual Studio Team Foundation Server (TFS).È anche possibile utilizzare il comando Collection per duplicare il database di una raccolta esistente, rinominarlo e connetterlo alla distribuzione.Questo processo viene talvolta detto clonazione di una raccolta.Tuttavia, non è possibile utilizzare il comando Collection per creare una raccolta di progetti team.Per ulteriori informazioni, vedere Creare una raccolta di progetti team.
Per gestire in modo interattivo le raccolte o per creare una raccolta è possibile utilizzare il nodo Raccolta 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 raccolte 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 la classe 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.
TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]
Parametri
Placeholder |
Descrizione |
|---|---|
CollectionName |
Specifica il nome della raccolta di progetti team.Se il nome della raccolta contiene spazi è necessario racchiudere il nome tra virgolette (ad esempio, "Raccolta"). |
ServerName |
Specifica il nome del server che ospita il database di configurazione di TFS 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 |
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 della raccolta specificata verrà aggiunto alla distribuzione di TFS. |
/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 della raccolta specificata verrà arrestato e la raccolta verrà disconnessa dalla distribuzione di TFS. |
/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 della raccolta specificata verrà arrestato e la raccolta verrà disconnessa in modo permanente da TFS.Non si sarà in grado di riconnettere il database della raccolta a questa o qualsiasi altra distribuzione. |
/CollectionName:CollectionName |
Obbligatorio se viene utilizzato /detach oppure /delete.Se utilizzata con /detach o /delete, questa opzione specifica la raccolta che verrà disconnessa o eliminata.Se si utilizza questa opzione con /attach, specifica un nuovo nome per la raccolta.Se utilizzata sia con /attach sia con /clone, questa opzione specifica il nome della raccolta duplicata. |
/CollectionDB:ServerName;DatabaseName |
Obbligatorio se viene utilizzato /attach.Questa opzione specifica il nome del server che esegue SQL Server e il nome del database della raccolta ospitato in tale server. |
/clone |
Se si specifica questa opzione, il database della raccolta originale verrà allegato come clone in SQL Server e tale database verrà connesso a TFS.Nella maggior parte dei casi questa opzione viene utilizzata nel processo di suddivisione di una raccolta di progetti team. |
Esempio
Nell'esempio seguente viene mostrato come rimuovere in modo permanente la raccolta di progetti team "Contoso Summer Intern Projects" da una distribuzione di Team Foundation Server.
[!NOTA]
Gli esempi utilizzati sono casuali e hanno solo scopo illustrativo.Nessuna associazione reale è intenzionale o può essere presupposta.
TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"
Nell'esempio seguente viene mostrato come duplicare la raccolta di progetti team "Contoso Summer Interns Projects", come denominarla "Contoso Winter Interns Projects" e come allegare la raccolta duplicata 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à
Move a Team Project Collection
Split a Team Project Collection
Concetti
Backup e ripristino della distribuzione