Teilen ü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

  • Zum Installieren von Erweiterungen müssen Sie Mitglied der Administratorengruppe für die Projektsammlung sein. 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.
  • Private Erweiterungen müssen für Ihre Organisation freigegeben werden, um installiert zu werden. Weitere Informationen zur Freigabe privater Erweiterungen finden Sie in der Dokumentation zur Veröffentlichung.
  • Nur Mitglieder der Gruppe "Projektsammlungsadministratoren" oder "Informationen auf Sammlungsebene bearbeiten" können Erweiterungen installieren. 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.
  • Private Erweiterungen müssen für Ihre Organisation freigegeben werden, um installiert zu werden. Weitere Informationen zur Freigabe privater Erweiterungen finden Sie in der Dokumentation zur Veröffentlichung.

Hinweis

Um ein vorhandenes Azure-Abonnement für die Abrechnung zu verwenden, müssen Sie mindestens über Administratorberechtigungen für dieses Abonnement verfügen. 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 Drittanbietererweiterungen "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 zahnradsymbol "Organisationseinstellungen" aus.

    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: Azure DevOps-Organisations-URL. 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

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.

  • Sie müssen Mitglied der Gruppe "Projektsammlungsadministratoren" sein oder der Organisationsbesitzer sein. Wenn Sie nicht über Berechtigungen verfügen, aber ein Projektmitglied sind, können Sie stattdessen Erweiterungen anfordern.
  • Wenden Sie sich bei einem Fehler "bereits installiert oder angefordert" an Ihren Project-Sammlungsadministrator, und bitten Sie ihn, die Erweiterung Ihnen zuzuweisen.

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 "Informationen auf Sammlungsebene bearbeiten" auf " Zulassen " in der Projektsammlung festlegen, in der Sie Erweiterungen installieren möchten. 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: Sie müssen 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.

  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: Sie müssen 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.

F: Gewusst wie Support für Azure-Abonnements, -Abrechnung und -Marketplace erhalten?

A: Wählen Sie je nach benötigtem Support aus den folgenden Artikeln aus:

Hinweis

Das Azure DevOps-Supportteam unterstützt keine Visual Studio Marketplace-Erweiterungen. Um Support zu Marketplace-Erweiterungen zu erhalten, suchen Sie die von Ihnen verwendete Erweiterung im Visual Studio Marketplace. Auf der Erweiterungsseite finden Sie einen Link zum GitHub-Repository, in dem Sie ein Problem erstellen können, oder einen Link erhalten, um Communitysupport zu erhalten.

Nächste Schritte