Verwalten von Linktypen [witadmin]

  • Artikel

Ähnlich den Arbeitsaufgabentypen, können Sie benutzerdefinierte Linktypen definieren und ändern. Sie können allerdings keine Änderungen an den systemdefinierten Linktypen vornehmen. Bevor Sie der Teamprojektauflistung einen neuen Linktyp hinzufügen, überprüfen Sie für die Verwendung verfügbaren Linktypen. Siehe Verknüpfen von Arbeitsaufgaben zur Unterstützung der Rückverfolgbarkeit.

Sie verwalten die Linktypen, 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. Bereits 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 aller für den Server definierten Linktypen exportieren.

  • importlinktype: Importiert die Definitionen der Linktypen von einer XML-Datei. Ist bereits ein Linktyp mit gleichem Verweisnamen vorhanden, wird er aktualisiert, sodass er dem importierten Linktyp entspricht. Ist der Linktyp noch nicht vorhanden, wird ein neuer Linktyp erstellt.

  • listlinktypes: Listet die verfügbare Gruppe von Linktypen auf dem Server auf.

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

Um das witadmin-Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, wo entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:

cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

Ersetzen Sie bei einer 32-Bit-Windows-Edition %programfiles(x86)% durch %programfiles%.

Anforderungen

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

  • Um Linktypen aufzulisten oder zu exportieren, muss die Berechtigung Projektebeneninformationen anzeigen für ein Teamprojekt in der Auflistung auf Zulassen festgelegt werden.

  • Zum Löschen, Importieren oder Reaktivieren von Linktypen müssen Sie Mitglied der Sicherheitsgruppe Projektauflistungsadministratoren sein, oder die Berechtigung Linktypen für Arbeitsaufgaben verwalten muss auf Zulassen festgelegt werden.

Weitere Informationen finden Sie unter Berechtigungsreferenz für Team Foundation Server.

Hinweis

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.Um ein Eingabeaufforderungsfenster mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü Eingabeaufforderung, und wählen Sie anschließend Als Administrator ausführen aus.Weitere Informationen finden Sie auf der Microsoft-Website Benutzerkontensteuerung.

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

Beschreibung

/collection:CollectionURL

Gibt den URI der Teamprojektauflistung an. Der URI hat folgendes Format: http://Servername:Port/VirtuellerVerzeichnisname/Auflistungsname

Beispiel:

http://ServerName: 8080/tfs/Collection0

Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format:

http://ServerName:Port/CollectionName

/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. /e:utf-7 gibt beispielsweise die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter weglassen, versucht witadmin die Codierung zu erkennen, und bei fehlgeschlagener Erkennung verwendet witadmin UTF-8.

/v

Überprüft den XML-Code für den Linktyp, 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 Linktyp-Definitionsschemas finden Sie unter Linktyp-Elementverweis.

Informationen zum Einschränken von Linkbeziehungstypen, die die Teammitglieder ausführen können, finden Sie unter Link-Steuerelemente, Einschränkungen und Feldverweis und LinksControlOptions-Elemente.

Beispiele

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

  • URI für die Teamprojektauflistung: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • 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/tfs/DefaultCollection

Auflisten der Definition eines Linktyps

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

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/tfs/DefaultCollection /n:mylinktype
witadmin activatelinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /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/tfs/DefaultCollection /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/tfs/DefaultCollection /f:mylinktype.xml

Siehe auch

Konzepte

Linktyp-Elementverweis

Link-Steuerelemente, Einschränkungen und Feldverweis

Weitere Ressourcen

Verknüpfen von Arbeitsaufgaben zur Unterstützung der Rückverfolgbarkeit

witAdmin: Anpassen und Verwalten von Objekten für die Arbeitsnachverfolgung