Collection-Befehl

Sie können den Collection-Befehl verwenden, um eine Teamprojektsammlung anzufügen, zu trennen oder aus einer Bereitstellung von Visual Studio Team Foundation Server (TFS) zu löschen.Sie können auch die Datenbank einer vorhandenen Auflistung mithilfe des Collection-Befehls duplizieren, umbenennen und an die Bereitstellung anfügen.Dieser Prozess wird manchmal als Klonen einer Auflistung bezeichnet.Sie können jedoch mithilfe des Collection-Befehls eine Teamprojektsammlung erstellen.Weitere Informationen finden Sie unter Erstellen einer Teamprojektsammlung.

Um Auflistungen interaktiv zu verwalten oder um eine Auflistung zu erstellen, können Sie den Knoten Teamprojektauflistungen in der Verwaltungskonsole für Team Foundation verwenden.Weitere Informationen finden Sie unter Öffnen der Team Foundation-Verwaltungskonsole und Organisieren des Servers mit Teamprojektsammlungen.

Erforderliche Berechtigungen

Zum Verwenden des Collections-Befehls müssen Sie Mitglied der folgenden Gruppen sein:

• der Sicherheitsgruppe Team Foundation-Administratoren und der Administratoren-Sicherheitsgruppe auf dem Server oder den Servern, die die Verwaltungskonsole für Team Foundation ausführen

• der Gruppe sysadmin auf den Servern, auf denen die Instanz von SQL Server ausgeführt wird, die die Datenbanken für Team Foundation Server hostet

• Die Gruppe Farmadministratoren für die Farm, aus der Sie die Siteauflistung löschen, wenn die Bereitstellung SharePoint-Produkte verwendet und Sie die /delete-Option verwenden.

Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen.

Hinweis
Sie müssen auch dann ein Fenster für erweiterte Eingabeaufforderung öffnen, wenn Sie sich mit Administratoranmeldeinformationen anmelden, um diese Funktion auszuführen.

TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName] [/collectionDB:ServerName;DatabaseName] [/clone]

Parameter

Platzhalter	Beschreibung
CollectionName	Gibt den Namen der Teamprojektauflistung an.Wenn der Name der Auflistung Leerzeichen enthält, müssen Sie den Namen in Anführungszeichen einschließen (z. B. "My Collection").
ServerName	Gibt den Namen des Servers an, der die Konfigurationsdatenbank für TFS hostet, und den Namen der Instanz, wenn Sie eine von der Standardinstanz abweichende Instanz verwenden.Wenn Sie eine Instanz angeben, muss das folgende Format verwendet werden: Servername\Instanzname
DatabaseName	Gibt den Namen der Konfigurationsdatenbank an.Standardmäßig lautet der Name dieser Datenbank TFS_ConfigurationDB.

Option	Beschreibung
/attach	Erforderlich, wenn weder /detach noch /delete verwendet wird.Wenn Sie diese Option angeben, müssen Sie auch die /collectionDB-Option angeben.Als Option können Sie auch /collectionName und /clone mit dieser Option verwenden.Wenn Sie die /attach-Option verwenden, wird die angegebene Auflistungsdatenbank der Bereitstellung von TFS hinzugefügt.
/detach	Erforderlich, wenn weder /attach noch /delete verwendet wird.Wenn Sie diese Option angeben, müssen Sie auch die /collectionName-Option angeben.Wenn Sie die /detach-Option verwenden, wird die Datenbank für die angegebene Auflistung beendet, und die Auflistung wird von der Bereitstellung von TFS getrennt.
/delete	Erforderlich, wenn weder /detach noch /attach verwendet wird.Wenn Sie diese Option angeben, müssen Sie auch die /collectionName-Option angeben.Wenn Sie die /delete-Option verwenden, wird die Datenbank für die angegebene Auflistung beendet, und die Auflistung wird permanent von TFS getrennt.Sie können die Auflistungsdatenbank nicht wieder an diese oder eine andere Bereitstellung anfügen.
/CollectionName:CollectionName	Erforderlich, wenn /detach oder /delete verwendet wird.Wenn Sie diese Option mit /detach oder /delete verwenden, gibt sie die Auflistung an, die getrennt oder gelöscht wird.Wenn Sie diese Option mit /attach verwenden, gibt sie einen neuen Namen für die Auflistung an.Wenn Sie diese Option mit /attach und /clone verwenden, gibt sie den Namen für die duplizierte Auflistung an.
/CollectionDB:ServerName;DatabaseName	Erforderlich, wenn /attach verwendet wird.Diese Option gibt den Namen des Servers an, der SQL Server ausführt, und den Namen der Auflistungsdatenbank, die auf diesem Server gehostet wird.
/clone	Wenn Sie diese Option angeben, wird die ursprüngliche Auflistungsdatenbank als Klon in SQL Server angefügt, und diese Datenbank wird an TFS angefügt.Diese Option wird hauptsächlich im Rahmen des Teilens einer Teamprojektauflistung verwendet.

Beispiel

Im folgenden Beispiel wird gezeigt, wie die "Contoso Summer Intern Projects"-Teamprojektauflistung permanent aus einer Bereitstellung von Team Foundation Server entfernt wird.

Hinweis
Die Beispiele dienen nur zu Illustrationszwecken und sind frei erfunden.Ähnlichkeiten mit real existierenden Personen oder Gegebenheiten sind rein zufällig und nicht beabsichtigt.

TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"

Im folgenden Beispiel wird gezeigt, wie die Teamprojektauflistung "Contoso Summer Interns Project" dupliziert, "Contoso Winter Interns Projects" benannt und die doppelte Auflistung an die Bereitstellung von Team Foundation Server angefügt wird.

TFSConfig Collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects" /CollectionName:"Contoso Winter Intern Projects" /clone

Siehe auch

Aufgaben

Move a Team Project Collection

Split a Team Project Collection

Konzepte

Sichern und Wiederherstellen der Bereitstellung

Weitere Ressourcen

Verwalten der Serverkonfiguration mit TFSConfig