Share via

Anpassen und Verwalten von Linktypen

  • Artikel

Sie können die Linktypen verwalten, die für eine Teamprojektauflistung definiert sind, indem Sie folgende witadmin-Befehle verwenden:

  • deactivatelinktype: Deaktiviert den angegebenen Linktyp. Benutzer können keine Links von diesem Typ mehr erstellen. Vorhandene Links dieses Typs funktionieren weiterhin ordnungsgemäß.

  • deletelinktype: Entfernt den angegebenen Linktyp unwiderruflich aus der Datenbank. Alle mit diesem Linktyp definierten Links werden auch entfernt.

  • exportlinktype: Exportiert die Definitionen von Linktypen. Sie können die Definition eines einzelnen Linktyps oder alle für den Server definierten Linktypen exportieren.

  • importlinktype: Importiert die Definitionen der Linktypen aus einer XML-Datei. Wenn ein Linktyp mit dem gleichen Verweisnamen bereits vorhanden ist, wird er auf den importierten Linktyp aktualisiert. Wenn der Linktyp nicht schon vorhanden ist, wird ein neuer Linktyp erstellt.

  • listlinktypes: Führt den verfügbaren Satz Linktypen auf einem Server auf.

  • reactivatelinktype: Aktiviert den angegebenen Linktyp erneut und weist ihm optional einen neuen Namen zu.

Das Befehlszeilenhilfsprogramm witadmin befindet sich im Verzeichnis Laufwerk:\Programme\Microsoft Visual Studio 10.0\Common7\IDE auf dem Clientcomputer, auf dem Team Explorer ausgeführt wird. 

Tipp

Mit dem Prozess-Editor, einem Powertool für Visual Studio, können Sie Linktypen erstellen und bearbeiten. Dieses Tool wird nicht unterstützt. Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Team Foundation Server Power Tools April 2010 (möglicherweise in englischer Sprache).

Erforderliche Berechtigungen

Für die Projektauflistung, in der die Linktypen definiert sind, müssen die folgenden Berechtigungen festgelegt sein:

  • Zum Aufführen oder Exportieren von Arbeitsaufgabentypen müssen Sie Mitglied der Gruppe Readers sein, oder die Berechtigung Arbeitsaufgaben in diesem Knoten anzeigen muss auf Zulassen festgelegt sein.

  • Zum Löschen, Importieren oder Reaktivieren von Linktypen müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder Projektadministratoren sein.

Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen und Team Foundation Server: Standardgruppen, Berechtigungen und Rollen.

Tipp

Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, 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 Microsoft-Website: Benutzerzugriffssteuerung.

witadmin deactivatelinktype /collection:CollectionURL /n:LinkName

witadmin deletelinktype /collection:CollectionURL /n:LinkName [/noprompt]

witadmin exportlinktype /collection:CollectionURL [/n:LinkName] [/f:FileName] [/e:Encoding] 

witadmin importlinktype /collection:CollectionURL /f:FileName [/e:Encoding] [/v]

witadmin listlinktypes /collection:CollectionURL

witadmin reactivatelinktype /collection:CollectionURL /n:LinkName

Parameter

Parameter

Beschreibungen

/collection:CollectionURL

Gibt den URI der Teamprojektsammlung an. Das Format für den URI sieht folgendermaßen aus: http://ServerName:Port/VirtuellerVerzeichnisname/Auflistungsname

Beispiele:

http://ServerName: 8080/tfs/Collection0

Wenn ein virtuelles Verzeichnis nicht verwendet wird, dann ist das Format für den URI folgendes:

http://Servername:Port/Auflistungsname

/n:LinkName

Der Name oder der Verweisname des Linktyps, der deaktiviert oder gelöscht werden soll.

/f:FileName

Die XML-Datei der Linktypen Für den Import erforderlich, optional für den Export. Wenn Sie diesen Parameter weglassen, wird die Befehlsausgabe auf der Anzeige angezeigt.

/e:encoding

Der Name eines .NET Framework 2.0-Codierungsformats. Die angegebene Codierung wird verwendet, um die XML-Daten zu exportieren oder zu importieren. Beispielsweise gibt /e:utf-7 die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter weglassen, versucht witadmin, die Codierung zu erkennen, und wenn Erkennung fehlschlägt, verwendet witadmin UTF-8.

/v

Überprüft das Linktyp-XML, ohne es zu importieren.

/noprompt

Deaktiviert die Eingabeaufforderung zur Bestätigung.

/? oder help

Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Die Struktur des Linktypdefinitionsschemas finden Sie unter Arbeiten mit Linktypen.

Beispiele

Falls nicht anders angegeben, gelten in jedem Beispiel die folgenden Werte:

  • URI für die Teamprojektsammlung: http://AdventureWorksServer:8080/AWTeam/Collection1

  • Servername: AdventureWorksServer

  • Eingabe- oder Ausgabedateiname: myLinkTypes.xml

  • Linktyp-Name: mylinktype

  • Standardcodierung: UTF-8

Auflisten von Linktypen

Mit dem folgenden Befehl werden die benutzerdefinierten Linktypen angezeigt, die für Team Foundation AdventureWorksServer definiert wurden.

witadmin listlinktypes /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Auflisten der Definition eines Linktyps

Im folgenden Beispiel wird die Definition des Linktyps im Eingabeaufforderungsfenster angezeigt:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1

Deaktivieren und anschließend Reaktivieren eines Linktyps

In den folgenden Beispielen wird der Linktyp "mylinktype" deaktiviert und dann erneut aktiviert:

witadmin deactivatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:mylinktype

Exportieren der Definition eines Linktyps

Der folgende Befehl exportiert die Definition aller Linktypen in die Datei mylinktype.xml:

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

Importieren der Definition von Linktypen

Im folgenden Beispiel wird die Definition der in der XML-Datei definierten Linktypen importiert:

witadmin importlinktype /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:mylinktype.xml

Siehe auch

Aufgaben

Hinzufügen eines Linktyps

Konzepte

Arbeiten mit Linktypen

Verknüpfen von Arbeitsaufgaben (Agile)

Weitere Ressourcen

Verknüpfen von Arbeitsaufgaben (CMMI)

Erstellen von Beziehungen zwischen Arbeitsaufgaben und anderen Ressourcen

witAdmin: Verwalten von Objekten für das Nachverfolgen von Arbeitsaufgaben