Verwalten von Linktypen

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Wichtig

Mit witadmin könnenSie XML-Definitionsdateien ändern, um das lokale XML-Prozessmodell zu unterstützen. Eine Übersicht über Prozessmodelle und die Unterstützten finden Sie unter Anpassen ihrer Arbeitsnachverfolgungserfahrung.

Ähnlich den Arbeitsaufgabentypen, können Sie benutzerdefinierte Linktypen definieren und ändern. Sie können allerdings keine Änderungen an den systemdefinierten Linktypen vornehmen. Bevor Sie ihrer Projektsammlung einen neuen Linktyp hinzufügen, überprüfen Sie die für Ihre Verwendung verfügbaren Linktypen. Weitere Informationen finden Sie unter Verwalten von Abhängigkeiten, Verknüpfen von Arbeitselementen.

Sie verwalten die für eine Projektsammlung definierten Linktypen mithilfe der folgenden witadmin-Befehle:

  • 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 dauerhaft 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 von Linktypen aus 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 den verfügbaren Satz von Linktypen auf einem Server auf.
  • reactivatelinktype:Aktiviert den angegebenen Linktyp erneut und weist ihm optional einen neuen Namen zu.

Ausführen des Witadmin-Befehlszeilentools

Um das Befehlszeilentool witadmin auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, in dem Visual Studio installiert ist. Das Befehlszeilentool witadmin wird mit einer beliebigen Version von Visual Studio. Sie können auf dieses Tool zugreifen, indem Sie die kostenlose Version von Visual Studio Community oder Visual Studio Team Explorer.

Hinweis

Wenn Sie eine Verbindung mit einem lokalen Server herstellen, müssen Sie die gleiche oder eine neuere Version von Visual Studio oder Team Explorer wie Azure DevOps Server TFS verwenden. Wenn Sie beispielsweise eine Verbindung mit einer TFS 2017-Instanz herstellen, müssen Sie eine Verbindung von Visual Studio 2017 oder Team Explorer 2017 herstellen. Es gibt keine Team Explorer 2015-Version.

Visual Studio 2019- oder Team Explorer 2019-Client:

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

oder , oder an Stelle von , je nach TeamExplorerProfessionalEnterpriseCommunity installierter Version.

Visual Studio 2017- oder Team Explorer 2017-Client:

%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

oder , oder an Stelle von , je nach TeamExplorerProfessionalEnterpriseCommunity installierter Version.

Visual Studio 2015-Client:

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

Visual Studio 2013 Client:

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

Team Explorer 2013-Client:

cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

Ersetzen Sie in einer 32-Bit-Edition von Windows %programfiles(x86)% durch %programfiles%. Sie können Visual Studio Community (die Zugriff auf Team Explorer bietet) oder Visual Studio Team Explorer 2017 kostenlos installieren.

Voraussetzungen

Für die Projektsammlung, in der die Linktypen definiert sind, müssen Sie über die folgenden Berechtigungen verfügen:

  • Um Linktypen auflisten oder exportieren zu können, muss die Berechtigung Informationen auf Projektebene anzeigen für ein Projekt in der Sammlung auf Zulassen festgelegt sein.
  • Zum Löschen, Importieren oder reaktiven Linktypen müssen Sie Mitglied der Sicherheitsgruppe Project-Sammlungsadministratoren sein oder die Berechtigung Arbeitselementlinktypen verwalten auf Zulassen festgelegt haben.

Weitere Informationen finden Sie unter Hinzufügen eines Administrators.

Hinweis

Auch wenn Sie sich mit Administratorberechtigungen anmelden, müssen Sie ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, um diese Funktion auf einem Server auszuführen, auf dem Windows Server 2008 ausgeführt wird. Um ein Eingabeaufforderungsfenster mit erhöhten Rechten zu öffnen, wählen Sie Startenaus, öffnen Sie das Kontextmenü Eingabeaufforderung, und wählen Sie dann Als Administrator ausführen aus. Weitere Informationen finden Sie auf der Microsoft-Website: User Access Control.

Syntax

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: Gibt den URI der Projektsammlung an. Zum Beispiel:

http://ServerName:Port/VirtualDirectoryName/CollectionName

Wenn kein virtuelles Verzeichnis verwendet wird, lautet das Format für den URI wie folgt: http://Servername:Port/Sammlungsname.
/n: Der Name oder der Verweisname des Linktyps, der deaktiviert oder gelöscht werden soll.
F: 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: 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 Unicode-Codierung (UTF-7) an. Wenn Sie diesen Parameter weglassen, versucht witadmin, die Codierung zu erkennen, und wenn die Erkennung fehlschlägt, 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 Hilfe Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Die Struktur des Schemas für die Linktypdefinition oder Informationen dazu, wie Sie die Typen von Linkbeziehungen einschränken können, die Teammitglieder erstellen können, finden Sie unter LinksControlOptions.

Beispiele

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

  • URI für die Projektsammlung: http://AdventureWorksServer:8080/tfs/DefaultCollection
  • Servername: AdventureWorksServer
  • Eingabe- oder Ausgabedateiname: myLinkTypes.xml
  • Linktyp-Name: mylinktype
  • Standardcodierung: UTF-8

Der folgende Befehl zeigt die benutzerdefinierten Linktypen an, die für Team Foundation AdventureWorksServer definiert sind.

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

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

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

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  

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

witadmin exportlinktype /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:mylinktype.xml  

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