Teilen über

Installieren von Erweiterungen

  • Artikel

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Installieren, Zuweisen, Deaktivieren und Deinstallieren von Erweiterungen, die neue Features und Funktionen für Azure DevOps hinzufügen.

Weitere Informationen zu Erweiterungen finden Sie in den Übersichten zur Entwicklung und Veröffentlichung .

Voraussetzungen

Hinweis

Wenn Sie ein vorhandenes Azure-Abonnement für die Abrechnung verwenden möchten, verfügen Sie mindestens über die Berechtigungen des Co-Administrators für dieses Abonnement. Wenn Sie nicht über Berechtigungen verfügen, kann ein Azure-Kontoadministrator oder -Dienstadministrator Sie als Co-Administrator zum Azure-Abonnement im Azure-Portal hinzufügen.

Ihre Projektsammlung verwendet Ihr Azure-Abonnement für zukünftige Marketplace-Käufe. Wo finde ich weitere Informationen zur Azure-Abrechnung?

Installieren einer Erweiterung

Installieren Sie eine Erweiterung in Ihrer Organisation, indem Sie die folgenden Schritte ausführen.

  1. Melden Sie sich bei Ihrem organization (https://dev.azure.com/{yourorganization}) an.

  2. Wählen Sie das Einkaufstaschensymbol und dann "Marketplace durchsuchen" aus.

    Screenshot mit hervorgehobenen Symbol für Einkaufstaschen und Auswahl der Schaltflächen

  3. Suchen Sie die Erweiterung, die Sie installieren möchten, und wählen Sie "Kostenlos abrufen" aus.

    Screenshot mit rotem Quadrat mit hervorhebung der Schaltfläche

  4. Wählen Sie Im Dropdownmenü Ihre Organisation und dann "Installieren" aus, um die Erweiterung zu installieren.

    Organisation für diese Erweiterung auswählen

Ihre Erweiterung ist jetzt installiert! Sie können jetzt zu Ihrer Organisation wechseln, um Ihre Erweiterung zu verwenden. Informieren Sie Ihr Team auch über diese Erweiterung, damit sie mit der Verwendung seiner Funktionen beginnen können.

Erweiterung wurde installiert

  1. Wechseln Sie zu Marketplace.visualstudio.com.

  2. Melden Sie sich mit Ihren Azure DevOps-Anmeldeinformationen an.

  3. Suchen Sie die Erweiterung, die Sie installieren möchten. Verwenden Sie das Suchfeld, um die Liste der Erweiterungen zu filtern.

    Screenshot der Auswahl einer Erweiterung.

  4. Wählen Sie die Erweiterung und dann "Abrufen " oder "Kostenlos abrufen" aus. Oder wählen Sie für einige Nicht-Microsoft-Erweiterungen Erste Schritte aus, um Preisinformationen und erweiterungsspezifische Installationsanweisungen anzuzeigen.

    Screenshot des Abrufens der Erweiterungen.

    Wenn Sie nicht über die Berechtigung zum Installieren der Erweiterung verfügen, können Sie einen Administrator bitten, sie für Sie zu installieren. Ihre Anforderung wird in Azure DevOps Server gespeichert und kann von einem Administrator beachtet werden.

  5. Wählen Sie "Herunterladen " aus, um die Vsix-Datei herunterzuladen.

  6. Laden Sie das vsix auf Ihren lokalen Marketplace hoch. Öffnen Sie Ihre Azure DevOps Server-Startseite (https://{server}:DefaultCollection).

  7. Wechseln Sie zu "Sammlungseinstellungen>Durchsuchen lokaler Erweiterungen".

    Screenshot der Auswahl, Schaltfläche

  8. Wählen Sie "Erweiterungen verwalten" aus, und laden Sie dann die Vsix-Datei hoch.

    Screenshot der Auswahl, Erweiterungen verwalten.

  9. Installieren Sie die Erweiterung in Ihrer Projektsammlung auf der Seite "Erweiterungen verwalten". Wählen Sie die Projektsammlung aus, in der Sie die Erweiterung installieren möchten, und wählen Sie "Installieren" aus.

Screenshot der Projektsammlung auswählen und

  1. Wechseln Sie nach Abschluss der Installation zur Projektsammlung, oder kehren Sie zum Marketplace zurück, um weitere Erweiterungen zu finden.

Screenshot der abgeschlossenen Installation der Erweiterung.

Deinstallieren oder Deaktivieren einer Erweiterung

  1. Melden Sie sich bei Ihrem organization (https://dev.azure.com/{yourorganization}) an.

  2. Wählen Sie zahnradsymbolOrganisationseinstellungen.

    Screenshot der Einstellungen für

  3. Wählen Sie "Erweiterungen" und dann die Erweiterung aus, die Sie deinstallieren oder deaktivieren möchten.

    Screenshot mit

  4. Wählen Sie "Deinstallieren" aus, oder wählen Sie die Auslassungspunkte (...) und dann "Deaktivieren" aus.

    Screenshot mit Deaktivier- oder Deinstallationserweiterungsaktionen.

Führen Sie die folgenden Schritte aus, um Erweiterungen in einer Auflistung zu deinstallieren.

  1. Wechseln Sie zum lokalen Katalogverwaltungsportal (http://{server}:8080/tfs/_gallery/manage).

  2. Wählen Sie für die gewünschte Erweiterung die Auslassungspunkte (...) und dann "Entfernen" aus.

    Screenshot der Aktion

Aktivieren oder Auflisten von Erweiterungen über die Befehlszeile

Aktivieren Sie eine Erweiterung mit dem Befehl "az devops extension enable ". Informationen zu den ersten Schritten finden Sie unter Erste Schritte mit der Azure DevOps-CLI.

az devops extension enable --extension-name
                           --publisher-name
                           [--org]

Parameter – Erweiterung aktivieren

  • erweiterungsname: Der Name der zu aktivierenden Erweiterung.
  • Herausgebername: Der Name des Erweiterungsherausgebers.
  • org: URL der Azure DevOps-Organisation. Konfigurieren Sie die Standardorganisation mit az devops configure -d organization=ORG_URL. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird. Beispiel: --org https://dev.azure.com/MyOrganizationName/.

Beispiel : Erweiterung aktivieren

Mit dem folgenden Befehl wird die Timetracker-Erweiterung aktiviert und das Ergebnis im Tabellenformat angezeigt.

az devops extension enable --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       none

Erweiterungen auflisten

Sie können die Erweiterungen, die in Ihrer Organisation installiert sind, mit dem Befehl "az devops extension list" auflisten. Informationen zu den ersten Schritten finden Sie unter Erste Schritte mit der Azure DevOps-CLI.

az devops extension list [--include-built-in {false, true}]
                         [--include-disabled {false, true}]
                         [--org]

Optionale Parameter – Listenerweiterungen

  • include-built-in: Include the built-in extensions. Akzeptierte Werte sind "true " (Standard) und "false".
  • include-disabled: Include the disabled extensions. Akzeptierte Werte sind "true " (Standard) und "false".
  • org: URL der Azure DevOps-Organisation. Sie können die Standard-organization mit az devops configure -d organization=ORG_URLkonfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird. Beispiel: --org https://dev.azure.com/MyOrganizationName/.

Beispiel : Listenerweiterungen

Der folgende Befehl listet Erweiterungen in Ihrer Organisation auf. Sie schließt die deaktivierten und integrierten Erweiterungen aus und zeigt die Ergebnisse im Tabellenformat an.

az devops extension list --include-built-in false --include-disabled false -output table

Publisher Id    Extension Id             Name                     Version              Last Updated     States         		 Flags
--------------  -----------------------  -----------------------  -------------------  ---------------  -----------------------  -------
ms              vss-analytics            Analytics                18.160.0.2130149925  2019-11-22       multiVersion, truste...  trusted
ms              vss-code-search          Code Search              18.160.0.1640944814  2019-11-22       multiVersion, truste...  trusted
ms              vss-plans                Delivery Plans           18.160.0.1266795967  2019-11-25       multiVersion, truste...  trusted
ms-eswm         dependencytracker        Dependency Tracker       2.1910.12801         2019-10-28       none
ms-devlabs      workitem-feature-tim...  Feature timeline and...  0.0.357              2019-10-14       none
AgileParts      gantt                    GANTT chart              1.0.79               2019-10-25       none
gordon-bee...   github                   GitHub Widget            0.10.0               2016-03-16       none
ms-devlabs      vsts-extensions-mult...  Multivalue control       2.2.26               2019-11-15       none
agile-exte...   product-vision           Product Vision           2.0.6                2019-06-04       none
mohitbagra      related-workitems        Related Work items       2.0.4                2017-11-12       none
YodLabs         TagsManager2             Tags Manager             0.9.31               2019-02-04       none
ms-devlabs      team-calendar            Team Calendar            2.0.15               2019-11-01       none
ms              vss-testmanager-web      Test Manager for TFS...  18.160.0.2130893445  2019-11-25       multiVersion, truste...  trusted
mmanela         vsts-workitem-recent...  Who recently viewed ...  1.0.4                2019-03-22       none
ottostreif...   wiql-editor              Wiql Editor              2.0.90               2019-06-21       none
mohitbagra      workitem-checklist       Work item checklist      3.2.4                2019-06-24       none
mohitbagra      witoneclickactions       Work item form one c...  2.3.2                2018-04-03       none
ms-devlabs      WorkItemVisualizatio...  Work Item Visualizat...  1.4.64               2018-04-03       none

Listenerweiterungsinformationen

Sie können die Details zu einer Erweiterung mit dem Befehl "az devops extension show" auflisten . Informationen zu den ersten Schritten finden Sie unter Erste Schritte mit der Azure DevOps-CLI.

az devops extension show --extension-name
                         --publisher-name
                         [--org]

Parameter – Informationen zur Listenerweiterung

  • erweiterungsname: Der Name der Erweiterung.
  • Herausgebername: Der Name des Erweiterungsherausgebers.
  • org: URL der Azure DevOps-Organisation. Sie können die Standard-organization mit az devops configure -d organization=ORG_URLkonfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird. Beispiel: --org https://dev.azure.com/MyOrganizationName/.

Beispiel : Listenerweiterungsinformationen

Der folgende Befehl zeigt Informationen zur Timetracker-Erweiterung im Tabellenformat.

az devops extension show --extension-name Timetracker --publisher-name 7pace --output table

Publisher Id    Extension Id    Name         Version      Last Updated     States
--------------  --------------  -----------  -----------  ---------------  --------
7pace           Timetracker     Timetracker  5.0.1.34507  2019-11-13       disabled

Behandlung von Problemen bei der Installation von Erweiterungen

Führen Sie die folgenden Schritte zur Problembehandlung aus, um häufige Probleme zu beheben:

  • Erweiterung kann nicht installiert werden:

    • Berechtigungen überprüfen: Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen zum Installieren von Erweiterungen verfügen. Sie müssen ein Project-Sammlungsadministrator sein oder über die erforderlichen Berechtigungen verfügen, die von einem Administrator erteilt wurden.
    • Überprüfen der Erweiterungskompatibilität: Sicherstellen, dass die Erweiterung mit Ihrer Version von Azure DevOps kompatibel ist. Überprüfen Sie die Detailseite der Erweiterung auf Kompatibilitätsinformationen.
    • Netzwerkprobleme: Überprüfen Sie, ob Ihre Netzwerkverbindung stabil ist und dass keine Firewall- oder Proxyeinstellungen den Installationsprozess blockieren.

  • Erweiterung stürzt ab oder verursacht Fehler:

    • Diagnoseinformationen sammeln: Wenn eine Erweiterung abstürzt oder Fehler verursacht, sammeln Sie Diagnoseinformationen, um das Problem zu identifizieren. Diese Informationen umfassen Fehlermeldungen, Protokolle und Screenshots des Problems.
    • Überprüfen von Erweiterungsprotokollen: Einige Erweiterungen stellen Protokolle bereit, die bei der Diagnose von Problemen helfen können. In der Dokumentation der Erweiterung finden Sie Informationen dazu, wie Sie auf diese Protokolle zugreifen und diese interpretieren können.
    • Wenden Sie sich an den Support: Wenn Sie das Problem nicht beheben können, wenden Sie sich mit den gesammelten Diagnoseinformationen an das Supportteam der Erweiterung. Geben Sie so viele Details wie möglich an, um ihnen bei der Problembehandlung zu helfen.

  • Erweiterung nach der Installation nicht sichtbar:

    • Seite aktualisieren: Manchmal wird die Erweiterung möglicherweise nicht unmittelbar nach der Installation angezeigt.
    • Berechtigungen überprüfen: Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen zum Anzeigen und Verwenden der Erweiterung verfügen. Einige Erweiterungen erfordern möglicherweise bestimmte Berechtigungen, um sichtbar zu sein.
    • Installieren Sie die Erweiterung erneut: Wenn die Erweiterung immer noch nicht sichtbar ist, versuchen Sie, sie zu deinstallieren und erneut zu installieren.

Häufig gestellte Fragen (FAQs)

F: Warum wird meine Organisation nicht auf der Marketplace-Installationsseite angezeigt?

A: Wenn Ihre Organisation beim Kauf über den Azure DevOps Marketplace nicht angezeigt wird, probieren Sie die folgenden Schritte aus:

  1. Überprüfen Sie die Identität, mit der Sie sich beim Visual Studio Marketplace anmelden. Wählen Sie in der oberen rechten Ecke Ihren Benutzernamen aus, um Ihr Profil anzuzeigen.
  2. Stellen Sie sicher, dass Ihre E-Mail-Adresse und Ihr Verzeichnis korrekt sind.
  3. Schließen Sie alle Browserfenster.
  4. Öffnen Sie eine private oder inkognito-Browsersitzung.
  5. Melden Sie sich beim Visual Studio Marketplace an. Verwenden Sie die Identität eines Benutzers in der gewünschten Organisation.

Tipp

Azure DevOps fordert Sie möglicherweise auf, zwischen "Geschäfts-, Schul- oder Unikonto" oder "persönliches Konto" zu wählen. Wenn ja, haben Sie eine E-Mail-Adresse verwendet, die für ein Microsoft-Konto identisch ist, und ein "Geschäfts-, Schul- oder Unikonto", das Ihre Organisation in Microsoft Entra ID verwaltet. Obwohl diese Identitäten dieselbe E-Mail-Adresse haben, sind sie immer noch separate Identitäten mit unterschiedlichen Profilen, Sicherheitseinstellungen und Berechtigungen. Wählen Sie die Identität für den Benutzer in der Organisation aus, die Sie auswählen möchten.

F: Warum kann ich keine Erweiterung installieren?

A: Sie können Erweiterungen aus einem der folgenden Gründe nicht installieren.

F: Warum können Benutzer nicht auf Erweiterungsfeatures zugreifen?

A: Benutzer können aus einem der folgenden Gründe nicht auf eine Erweiterung zugreifen.

  • Für die meisten Erweiterungen ist es erforderlich, dass Benutzer mindestens über einfachen Zugriff verfügen, nicht über Einen Projektbeteiligten. Sie können z. B. die kostenlose Codesuche-Erweiterung installieren, aber jeder Benutzer muss mindestens über einfachen Zugriff verfügen, um nach Code zu suchen. Um Ihrem Team zu helfen, die App-Qualität zu verbessern, können Sie die kostenlose Test - Feedback-Erweiterung installieren. Sie erleben unterschiedliche Funktionen, basierend auf Ihrer Zugriffsebene und unabhängig davon, ob Sie offline arbeiten oder mit Azure DevOps Services oder einem lokalen Azure DevOps-Server verbunden sind. Weitere Informationen finden Sie in der Beschreibung der Erweiterung auf der Registerkarte "Azure DevOps" in Visual Studio Marketplace.

  • Wenn Sie eine Organisation verwenden und eine kostenlose Erweiterungstest gestartet haben, ist Ihre Testversion möglicherweise abgelaufen. Überprüfen Sie, ob Ihre Testversion abgelaufen ist.

    1. Wählen Sie auf der Symbolleiste Ihrer Organisation "Benutzer" aus.
    2. Wechseln Sie zum Erweiterungsbereich.
    3. Überprüfen Sie, ob die Erweiterung abgelaufen ist, um nach einer Ablaufmeldung zu suchen.

  • Wenn Sie eine Organisation verwenden und diese Erweiterung bezahlt haben, stellen Sie sicher, dass Sie diese Erweiterung Benutzern zugewiesen haben.

    1. Wechseln Sie auf der Symbolleiste Ihrer Organisation zu "Benutzer".
    2. Wechseln Sie zum Erweiterungsbereich.
    3. Überprüfen Sie, ob die Erweiterung dem Benutzer zugewiesen ist. Wenn dies nicht der Grund ist, weisen Sie die Erweiterung dem Benutzer zu.

Weitere Informationen finden Sie unter Zuweisen von Erweiterungen zu Benutzern.

F: Was ist mit meiner Vorschauerweiterung passiert?

A: Ihre Erweiterung ist möglicherweise nicht mehr in der Vorschau. Nach einem Vorschauzeitraum ist eine Längere Verlängerung allgemein als kostenpflichtige Erweiterung verfügbar. Eine Nachfrist kann angeboten werden, bevor Sie die Verlängerung kaufen müssen. Alle Vorschauerweiterungen werden automatisch in eine kostenlose Testversion konvertiert, bevor Sie die Erweiterung kaufen müssen.

F: Warum kann ich keine Erweiterungen für Azure DevOps Server installieren?

A: Sie können Erweiterungen für Azure DevOps Server aus einem der folgenden Gründe nicht installieren:

  • Sie müssen Mitglied der Gruppe Projektsammlungsadministratoren sein, oder die Berechtigung zum Bearbeiten von Informationen auf Sammlungsebene muss in der Projektsammlung, in der Sie die Erweiterungen installieren möchten, auf Zulassen festgelegt sein. Wenn Sie nicht über Berechtigungen verfügen, können Sie stattdessen Erweiterungen anfordern.
  • Möglicherweise wird eine Fehlermeldung angezeigt, die besagt, dass Sie die Erweiterung bereits installiert oder angefordert haben. Wenn ja, wenden Sie sich an ein Mitglied der Gruppe "Projektsammlungsadministratoren ", und bitten Sie sie, die Erweiterung Ihnen zuzuweisen. Weitere Informationen finden Sie unter Anfordern einer Erhöhung der Berechtigungsstufen.

F: Warum wird die gewünschte Projektsammlung (lokal) nicht angezeigt?

A: Mitglied Ihrer Projektsammlung sein. Führen Sie die folgenden Schritte aus, um Ihre Identität zu überprüfen, mit der Sie sich beim Marketplace anmelden.

  1. Wechseln Sie auf Der Startseite des Azure DevOps Server-Webportals (https://{server}:8080/tfs/) zur oberen rechten Ecke der Seite, und wählen Sie Ihren Benutzernamen aus, um Ihr Profil anzuzeigen.
  2. Stellen Sie auf der linken Seite Ihres Profils sicher, dass Ihre E-Mail-Adresse und Ihr Verzeichnis korrekt sind.
  3. Schließen Sie alle Browserfenster.
  4. Öffnen Sie eine private oder inkognito-Browsersitzung.
  5. Melden Sie sich bei Ihrer Azure DevOps Server-Startseite (https://{server}:8080/tfs/) mit der Identität an, die ein Benutzer in der Projektsammlung ist, in der Sie die Erweiterung installieren möchten.

Azure DevOps fordert Sie möglicherweise auf, zwischen einer "Geschäfts-, Schul- oder Uniorganisation" oder "persönliches Konto" zu wählen. Diese Meldung bedeutet, dass Sie eine E-Mail-Adresse verwendet haben, die für ein Microsoft-Konto und ein "Geschäfts-, Schul- oder Unikonto" von Ihrer Organisation in microsoft Entra ID verwaltet wird. Obwohl diese Identitäten dieselbe E-Mail-Adresse haben, sind sie immer noch separate Identitäten mit unterschiedlichen Profilen, Sicherheitseinstellungen und Berechtigungen. Wählen Sie die Identität aus, die der Benutzer in Ihrer Projektsammlung ist.

  1. Wechseln Sie aus Ihrer Projektsammlung zum Marketplace.

F: Warum soll die Erweiterung, die ich möchte, keine Downloadschaltfläche (lokal) anzeigen?

A: Einige Erweiterungen funktionieren nur mit Azure DevOps Services aus einem der folgenden Gründe:

  • Die Erweiterung verwendet Azure DevOps-Features, die noch nicht für Azure DevOps Server veröffentlicht wurden.
  • Das Erweiterungsmanifest gibt an, dass die Erweiterung nur für Azure DevOps Services (Ziele = Microsoft.Visualstudio.Services.Cloud) verfügbar ist.
  • Das Erweiterungsmanifest gibt an, dass die Erweiterung eine Integration ist (Ziele = Microsoft.Visualstudio.Services.Integration).

F: Warum kann ich Keine Erweiterungen auf Azure DevOps Server hochladen?

A: Mitglied der Gruppe Team Foundation-Administratoren sein. Außerdem müssen Sie über Berechtigungen auf Instanzenebene bearbeiten für den Azure DevOps-Server verfügen, auf dem Sie Erweiterungen hochladen möchten.

Nächste Schritte

Verwalten von Erweiterungsberechtigungen