Verwalten von Linktypen

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Wichtig

Für das lokale XML-Prozessmodell können Sie witadmin zum Auflisten, Importieren, Exportieren und Ändern eines Prozesses für ein Projekt verwenden. Für die Prozessmodelle Geerbte und gehostete XML-Prozesse können Sie nur witadmin zum Auflisten und Exportieren von Prozessinformationen verwenden. Eine Übersicht über Prozessmodelle und was unterstützt wird, finden Sie unter Anpassen der Arbeitsverfolgungserfahrung.

Ä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 mit den folgenden witadmin Befehlen:

  • 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. Wenn der Linktyp noch nicht vorhanden ist, wird ein neuer Linktyp erstellt.
  • listlinktypes: Listet den verfügbaren Satz von Linktypen auf einem Server auf.
  • reactivatelinktype: Reaktiviert den angegebenen Linktyp und weist ihm optional einen neuen Namen zu.

Ausführen des Befehlszeilentools witadmin

Öffnen Sie zum Ausführen des witadmin Befehlszeilentools ein Eingabeaufforderungsfenster, in dem Visual Studio installiert ist. Das witadmin Befehlszeilentool wird mit jeder Version von Visual Studio installiert. Sie können auf dieses Tool zugreifen, indem Sie die kostenlose Version von Visual Studio Community oder Visual Studio Team Explorer installieren.

Hinweis

Wenn Sie eine Verbindung mit Azure DevOps Services herstellen, wird empfohlen, die neueste Version von Visual Studio oder Visual Studio Community zu verwenden.

Hinweis

Wenn Sie eine Verbindung mit einem lokalen Server herstellen, empfiehlt es sich, dieselbe oder eine höhere Version von Visual Studio wie Ihre Azure DevOps Server zu verwenden. Wenn Sie beispielsweise eine Verbindung mit Azure DevOps Server 2019 herstellen, stellen Sie über eine Version von Visual Studio 2019 eine Verbindung mit Ihrem Projekt her.

Für Visual Studio 2022

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

oder Professional oder Enterprise anstelle von Community, je nach installierter Version.

Für Visual Studio 2019:

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

oder Professional oder Enterprise anstelle von Community, je nach installierter Version.

Für Visual Studio 2017:

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

oder TeamExplorer oder Professional anstelle von Enterprise, je nach installierter Version.

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

Voraussetzungen

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

  • Zum Auflisten oder Exportieren von Linktypen muss die Berechtigung Informationen auf Projektebene anzeigen für ein Projekt in der Sammlung auf Zulassen festgelegt sein.
  • Zum Löschen, Importieren oder reaktiven Linktyp müssen Sie Mitglied der Sicherheitsgruppe Projektsammlungsadministratoren sein oder die Berechtigung Arbeitselementlinktypen verwalten auf Zulassen festgelegt haben.

Weitere Informationen finden Sie unter Ändern von Berechtigungen auf Der Projektsammlungsebene.

Hinweis

Selbst 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 Start aus, öffnen Sie das Kontextmenü Eingabeaufforderung , und wählen Sie dann Als Administrator ausführen aus. Weitere Informationen finden Sie auf der Microsoft-Website: Benutzer 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:CollectionURL Gibt den URI der Projektauflistung an. Beispiel:

Lokales Format:http://ServerName:Port/VirtualDirectoryName/CollectionName
Wenn kein virtuelles Verzeichnis verwendet wird, verwenden Sie 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 Codierungsformats 2.0. Die angegebene Codierung wird verwendet, um die XML-Daten zu exportieren oder zu importieren. Gibt beispielsweise /e:utf-7 die Unicode-Codierung (UTF-7) an. Wenn Sie diesen Parameter weglassen, versucht, witadmin die Codierung zu erkennen, und wenn die Erkennung fehlschlägt, witadmin wird UTF-8 verwendet.
/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.

Bemerkungen

Die Struktur des Linktypdefinitionsschemas 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 Projektauflistung: 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