Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Melden Sie sich bei Ihrer Organisation (
https://dev.azure.com/{Your_Organization}
) an.Wählen Sie das Einkaufstaschensymbol und dann "Marketplace durchsuchen" aus.
Suchen Sie die Erweiterung, die Sie installieren möchten, und wählen Sie "Kostenlos abrufen" aus.
Wählen Sie Im Dropdownmenü Ihre Organisation und dann "Installieren" aus, um die Erweiterung zu installieren.
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.
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
Melden Sie sich bei Ihrer Organisation (
https://dev.azure.com/{Your_Organization}
) an.Wählen Sie
Organisationseinstellungen aus.
Wählen Sie "Erweiterungen" und dann die Erweiterung aus, die Sie deinstallieren oder deaktivieren möchten.
Wählen Sie Deinstallieren oder wählen Sie die Ellipsen (...), und wählen Sie dann Deaktivieren.
Führen Sie die folgenden Schritte aus, um Erweiterungen in einer Auflistung zu deinstallieren:
Wechseln Sie zum lokalen Katalogverwaltungsportal (
http://{server}:8080/tfs/_gallery/manage
).Wählen Sie für die gewünschte Erweiterung die Ellipsen (...) und wählen Sie dann Entfernen.
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 mitgit config
verwendet 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 mitgit config
verwendet 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 mitgit config
verwendet 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:
- Ü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.
- Stellen Sie sicher, dass Ihre E-Mail-Adresse und Ihr Verzeichnis korrekt sind.
- Schließen Sie alle Browserfenster.
- Öffnen Sie eine private oder inkognito-Browsersitzung.
- 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.
- Sie müssen Mitglied der Gruppe Projektsammlungsadministratoren sein oder Sie sind der Organisationsbesitzer. Wenn Sie nicht über Berechtigungen verfügen, aber ein Projektmitglied sind, können Sie stattdessen Erweiterungen anfordern.
- Bei der Fehlermeldung "bereits installiert oder angefordert" wenden Sie sich an den Administrator Ihrer Projektsammlung und bitten ihn, Ihnen die Erweiterung 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 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.
- Wählen Sie auf der Symbolleiste Ihrer Organisation "Benutzer" aus.
- Rufen Sie das Fenster für die Erweiterung auf.
- Ü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.
- Wechseln Sie auf der Symbolleiste Ihrer Organisation zu "Benutzer".
- Rufen Sie das Fenster für die Erweiterung auf.
- Ü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.
- 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. - Stellen Sie auf der linken Seite Ihres Profils sicher, dass Ihre E-Mail-Adresse und Ihr Verzeichnis korrekt sind.
- Schließen Sie alle Browserfenster.
- Öffnen Sie eine private oder inkognito-Browsersitzung.
- 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. - 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.