Freigeben über


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 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 mithilfe des Collection-Befehls eine Teamprojektsammlung erstellen. Weitere Informationen finden Sie unter Erstellen einer Teamprojektsammlung.

Um Auflistungen interaktiv zu verwalten oder eine Auflistung zu erstellen, können Sie den Teamprojektsammlungen-Knoten 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 der Farm, aus der Sie die Siteauflistung löschen, wenn die Bereitstellung SharePoint-Produkte verwendet und Sie die /delete-Option verwenden.

Weitere Informationen hierzu finden Sie unter Team Foundation Server-Berechtigungen.

Tipp

Sie müssen auch dann eine Eingabeaufforderung mit erhöhten Rechten öffnen, wenn Sie sich mit Administratoranmeldeinformationen anmelden, um diese Funktion auf einem Server auszuführen, auf dem Windows Server 2008 ausgeführt wird. Klicken Sie zum Öffnen eines Eingabeaufforderungsfensters mit erhöhten Rechten auf Start, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. Weitere Informationen finden Sie auf der folgenden Seite auf der Microsoft-Website: Benutzerkontensteuerung.

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

Parameter

Platzhalter

Beschreibungen

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 Team Foundation Server und den Namen der Instanz hostet, 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

Beschreibungen

/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 Team Foundation Server 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 Team Foundation Server 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 Team Foundation Server getrennt. Sie sind nicht zu in der Lage, die Auflistungsdatenbank an dieses oder eine beliebige andere Bereitstellung wieder anzufü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 angegeben 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 Auflistungsdatenbank in SQL Server dupliziert, und die duplizierte Datenbank wird an Team Foundation Server angefügt. Diese Option wird hauptsächlich im Rahmen des Teilens einer Teamprojektsammlung verwendet.

Beispiel

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

Tipp

Die in den Beispielen verwendeten Firmen, Organisationen, Produkte, Domänennamen, E-Mail-Adressen, Logos, Personen, Orte und Ereignisse sind frei erfunden. Jede Ähnlichkeit mit bestehenden Firmen, Organisationen, Produkten, Domänennamen, E-Mail-Adressen, Logos, Personen, Orten oder Ereignissen ist rein zufällig.

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

Im folgenden Beispiel wird gezeigt, wie die Teamprojektsammlung "Contoso Summer Interns Project" dupliziert, mit "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

Verschieben einer Teamprojektsammlung

Teilen einer Teamprojektsammlung

Konzepte

Sichern und Wiederherstellen der Bereitstellung

Weitere Ressourcen

Verwalten der Serverkonfiguration mit TFSConfig