Freigeben über


Installieren von Erweiterungen

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

Kategorie Anforderungen
Berechtigungen Mitglied der Gruppe "Projektsammlungsadministratoren". Organisationsbesitzer sind automatisch Mitglieder dieser Gruppe. Wenn Sie keine Berechtigungen dafür haben, können Sie stattdessen Erweiterungen anfordern oder sich an einen Administrator für die Projektsammlung wenden.
Erweiterungsfreigabe Private Erweiterungen, die mit Ihrer Organisation geteilt werden.
Kategorie Anforderungen
Berechtigungen Mitglied der Gruppe "Projektsammlungsadministratoren" oder "Informationen auf Sammlungsebene bearbeiten"-Berechtigungen. Organisationsbesitzer sind automatisch Mitglieder dieser Gruppe. Wenn Sie keine Berechtigungen dafür haben, können Sie stattdessen Erweiterungen anfordern oder sich an einen Administrator für die Projektsammlung wenden.
Erweiterungsfreigabe Private Erweiterungen, die mit Ihrer Organisation geteilt werden.

Hinweis

Um ein vorhandenes Azure-Abonnement für die Abrechnung zu verwenden, verfügen Sie mindestens über Coadministratorberechtigungen für dieses Abonnement. Wenn Sie nicht über Berechtigungen verfügen, kann Ein Azure-Kontoadministrator oder -Dienstadministrator Sie als Coadministrator 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 Ihrer Organisation (https://dev.azure.com/{Your_Organization}) an.

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

    Screenshot mit hervorgehobenem Einkaufstaschensymbol und der Auswahl der 'Marketplace durchsuchen'-Schaltfläche.

  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

Erhöhte Berechtigungen, Pipelinedecorators und unveröffentlichte Erweiterungen

Erweiterungen mit hohen Berechtigungsbereichen, Pipelinedekoratoren oder nicht veröffentlichtem Status können potenzielle Sicherheitsrisiken darstellen, wenn sie nicht ordnungsgemäß überprüft werden. Bereiche mit hohen Rechten gewähren umfangreichen Zugriff auf die Ressourcen Ihrer Organisation, während Pipelinedekoratoren alle Pipelines in Ihrer Organisation modifizieren können. Nicht veröffentlichte Erweiterungen werden möglicherweise nicht mehr von ihren Herausgebern verwaltet. Weitere Informationen zum Verwalten dieser Arten von Erweiterungen finden Sie unter Verwalten von Berechtigungsstufen mit hohen Privilegien, Pipeline-Dekoratoren und nicht veröffentlichten Erweiterungen.

Deinstallieren oder Deaktivieren einer Erweiterung

  1. Melden Sie sich bei Ihrer Organisation (https://dev.azure.com/{Your_Organization}) an.

  2. Wählen Sie ZahnradsymbolOrganisationseinstellungen aus.

    Screenshot mit „Organisationseinstellungen öffnen“.

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

    Screenshot, auf dem

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

    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 Ellipsen (...) und wählen Sie dann Entfernen.

    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: Eingebaute Erweiterungen einbeziehen. Akzeptierte Werte sind "true " (Standard) und "false".
  • include-disabled: Die deaktivierten Erweiterungen einschließen. Akzeptierte Werte sind "true " (Standard) und "false".
  • org: URL der Azure DevOps-Organisation. Sie können die Standard-Organisation mit az devops configure -d organization=ORG_URL konfigurieren. 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

Informationen zur Erweiterung auflisten

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-Organisation mit az devops configure -d organization=ORG_URL konfigurieren. Erforderlich, wenn nicht als Standard konfiguriert oder mit git configverwendet wird. Beispiel: --org https://dev.azure.com/MyOrganizationName/.

Beispiel - Informationen zur Erweiterung auflisten

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

Probleme bei der Erweiterungsinstallation beheben

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

  • Erweiterung kann nicht installiert werden:

    • Berechtigungen überprüfen: Um Erweiterungen zu installieren, stellen Sie sicher, dass Sie ein Project-Sammlungsadministrator sind oder über die erforderlichen Berechtigungen verfügen, die 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önlichem 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 Basic-Zugriff verfügen, nicht über Stakeholder-Zugriff. 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. Rufen Sie das Fenster für die Erweiterung auf.
    3. Überprüfen Sie, ob es eine Ablaufmeldung gibt, um festzustellen, ob oder wann Ihre Erweiterung abgelaufen ist.
  • 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. Rufen Sie das Fenster für die Erweiterung auf.
    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 Benutzern Erweiterungen zuweisen.

F: Was ist mit meiner Vorschauerweiterung passiert?

A: Ihre Erweiterung ist möglicherweise nicht 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 auf Ihrer Azure DevOps Server-Startseite (https://{server}:8080/tfs/) mit der Identität eines Benutzers der Projektsammlung an, 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, die der Benutzer in Ihrer Projektsammlung ist.
  6. 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 zum Bearbeiten auf Instanzenebene für den Azure DevOps Server verfügen, auf dem Sie Erweiterungen hochladen möchten.

Nächste Schritte