Freigeben über

Deinstallieren von Add-Ins in der Entwicklung

  • Artikel

Unvollständig entfernte Add-Ins können während der Entwicklung Artefakte auf Ihrem Computer hinterlassen, z. B. benutzerdefinierte Menübandschaltflächen oder Registrierungseinträge. In diesem Artikel nennen wir diese "Ghost-Add-Ins".

Outlook-Add-Ins können diese Artefakte auch anderen Computern hinzufügen, wenn Sie sich bei Outlook mit der gleichen ID anmelden, die Sie zum Entwickeln des Add-Ins verwendet haben.

Wichtig

Wenn Sie sich bei Outlook anmelden, werden alle Outlook-Add-In-Manifeste, die Ihrer ID zugeordnet sind, von Exchange heruntergeladen und quer geladen, einschließlich Add-Ins, die Sie auf einem anderen Computer mit derselben ID entwickeln. Beispielsweise werden alle benutzerdefinierten Menübandschaltflächen, die im Manifest definiert sind, für das Add-In angezeigt.

Wenn die URLs im Manifest auf einen Nicht-localhost-Server verweisen und dieser Server ausgeführt wird und auf den der Nichtentwicklungscomputer zugreifen kann, speichert Outlook die Dateien des Add-Ins im lokalen Dateisystem zwischen, und das Add-In wird normalerweise normal auf dem Computer ausgeführt. Andernfalls funktioniert das Add-In nicht, aber es werden sichtbare Teile wie benutzerdefinierte Menübandschaltflächen angezeigt. Sie verfügen über die im Manifest definierten Bezeichnungen. Die Schaltflächensymbole des Add-Ins werden auch angezeigt, wenn sie jemals lokal auf dem Nichtentwicklungscomputer zwischengespeichert wurden und der Cache nie gelöscht wurde. Symboldateien werden nicht mit Exchange gespeichert. Wenn sie also nie auf dem Nichtentwicklungscomputer zwischengespeichert wurden (oder der Cache gelöscht wurde), verfügen die Schaltflächen über Standardsymbole.

Bis die Registrierung des Add-Ins aus Exchange entfernt wird, wird das Add-In weiterhin angezeigt. Informationen zum Entfernen der Registrierung in Exchange finden Sie unter Entfernen eines Ghost-Add-Ins .

Dieser Artikel enthält einige Anleitungen, um die Wahrscheinlichkeit dieser Probleme zu minimieren und sie zu beheben, wenn sie auftreten.

Verhindern der Probleme

Wenn ein Add-In quergeladen wird, geschieht folgendes:

  • Ein Webserver( in der Regel auf localhost) wird gestartet, um die Dateien des Add-Ins (z. B. HTML-, CSS- und JavaScript-Dateien) bereitzustellen.
  • Diese Dateien werden auf Ihrem Entwicklungscomputer zwischengespeichert.
  • Das Add-In wird beim Entwicklungscomputer registriert. Die Registrierung erfolgt mit Registrierungseinträgen auf einem Windows-Computer oder mit bestimmten Dateien, die im Dateisystem auf einem Mac gespeichert sind.
  • Die meisten Tools zum Querladen von Add-Ins öffnen automatisch die Office-Anwendung, auf die das Add-In abzielt. Die Tools füllen die Anwendung auch mit benutzerdefinierten Menübandschaltflächen oder Kontextmenüelementen auf, die im Manifest des Add-Ins definiert sind.
  • Für ein Outlook-Add-In wird das Manifest des Add-Ins beim Exchange-Dienst registriert.

Verwenden der Deinstallationsfunktion Ihres Tools

Um Ghost-Add-Ins zu verhindern, beenden Sie jede Test-, Debug- und Querladensitzung, indem Sie die Deinstallationsoption (auch als unacquire bezeichnet) verwenden, die von dem Tool bereitgestellt wird, das Sie zum Starten der Sitzung verwendet haben. Dadurch werden die Auswirkungen des Querladens umgekehrt, wie weiter oben in diesem Artikel erwähnt.

In der folgenden Liste wird für jedes Tool angegeben, wie deinstalliert wird, aber die Prozeduren oder die Syntax werden nicht im Detail beschrieben. Verwenden Sie unbedingt die Links, um vollständige Anweisungen zu erhalten.

Hinweis

Einige dieser Tools schließen die Office-Anwendung, die automatisch geöffnet wird, nicht. Schließen Sie in diesem Fall die Anwendung manuell unmittelbar nach dem Beenden der Sitzung.

  • Yeoman-Generator für Office-Add-Ins (Yo Office):Verwenden Sie das npm stop Skript in derselben Befehlszeile, in der Sie die Sitzung mit npm startgestartet haben. Weitere Informationen finden Sie in den verschiedenen Artikeln in den Abschnitten Erste Schritte und Schnellstarts und Entfernen eines quergeladenen Add-Ins.
  • Teams Toolkit für Visual Studio Code: Wählen Sie Ausführen | Debuggen beenden in Visual Studio Code aus. Weitere Informationen finden Sie im letzten Schritt unter Erstellen eines Outlook-Add-In-Projekts , das auch für Nicht-Outlook-Add-Ins gilt.
  • Office Add-In Development Kit für Visual Studio Code: Wählen Sie bei geöffneter Office Add-In Development Kit-Erweiterung Die Vorschau Ihres Office-Add-Ins beenden aus. Weitere Informationen finden Sie unter Beenden des Testens Ihres Add-Ins.
  • office-addin-debugging-Tool: Verwenden Sie den office-addin-debugging stop Befehl in derselben Befehlszeile, in der Sie die Sitzung mit office-addin-debugging startgestartet haben. Weitere Informationen finden Sie unter Querladen mit dem Office-Addin-Debugging-Tool.
  • Teams Toolkit CLI: Verwenden Sie den teamsapp uninstall Befehl an derselben Befehlszeile, in der Sie die Sitzung mit teamsapp installgestartet haben. Weitere Informationen finden Sie unter Querladen mit der Teams Toolkit-CLI.
  • Visual Studio: Wählen Sie debuggen | Debuggen Debuggen beenden aus, oder drücken Sie UMSCHALT+F5, oder klicken Sie auf der Debugleiste auf die quadratische rote Schaltfläche "Stop". Alternativ wird beim Schließen der Office-Anwendung auch die Sitzung beendet und das Add-In deinstalliert. Weitere Informationen finden Sie unter Erster Blick auf den Visual Studio-Debugger.

Entfernen eines Ghost-Add-Ins

Um ein Ghost-Add-In zu entfernen, müssen Sie die Artefakte entfernen, die beim letzten Querladen erstellt wurden, die lokale Registrierung und für Outlook-Add-Ins die Registrierung in Exchange entfernen.

Der Prozess zum Entfernen des Add-Ins hängt davon ab, ob das Add-In für Outlook oder eine andere Office-Anwendung vorgesehen ist.

Hinweis

Im einheitlichen Manifest für Microsoft 365 kann ein Add-In konfiguriert werden, um Outlook und eine oder mehrere andere Office-Anwendungen zu unterstützen. Das heißt, es gibt mehr als ein Element des Arrays "extensions.requirements.scopes" im Manifest, und einer der Member ist "mail" (oder die Eigenschaft "extensions.requirements.scopes" ist nicht vorhanden). Behandeln Sie ein Add-In, das auf diese Weise konfiguriert ist, als Outlook-Add-In.

Wenn das Ghost-Add-In kein Outlook-Add-In ist, fahren Sie mit dem Abschnitt Entfernen der Add-In-Artefakte fort.

Entfernen der Exchange-Registrierung eines outlook-ghost-Add-Ins

  1. Melden Sie sich bei Outlook mit derselben ID an, die Sie beim Querladen des Add-Ins verwendet haben.

  2. Öffnen Sie PowerShell als Administrator.

  3. Run the following commands. Antworten Sie auf alle Bestätigungsaufforderungen mit "Ja".

    Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.4.0
Set-ExecutionPolicy RemoteSigned
Connect-ExchangeOnline

    Hinweis

    Wenn der Connect-ExchangeOnline Befehl den Fehler "ActiveX-Steuerelement '8856f961-340a-11d0-a96b-00c04fd705a2' kann nicht instanziiert werden, weil sich der aktuelle Thread nicht in einem Singlethread-Apartment befindet" zurückgibt, führen Sie den Befehl einfach ein zweites Mal aus. Dies ist ein bekannter Fehler.

  4. Führen Sie den folgenden Befehl aus. Antworten Sie auf alle Bestätigungsaufforderungen mit "Ja".

    Get-App | Format-Table -Auto DisplayName,AppId

    Eine Liste der in Outlook installierten Add-Ins wird angezeigt. Dazu gehören integrierte Microsoft-Add-Ins und -Add-Ins, die Sie installiert haben. Alle ghost Outlook-Add-Ins werden ebenfalls aufgelistet.

  5. Suchen Sie das Ghost-Add-In in der Liste. Wenn es mit Yo Office oder einem anderen Microsoft-Tool erstellt wurde, hat es wahrscheinlich den Namen "Contoso-Aufgabenbereich-Add-In".

  6. Kopieren Sie die App-ID (eine GUID) des Add-Ins. Sie benötigen sie für spätere Schritte.

  7. Führen Sie den Befehl Remove-App -Identity {{The GUID OF YOUR ADD-IN HERE}} aus (z. B. Remove-App -Identity 26ead0cb-10dd-4ba2-86c6-4db111876652). Dieser Befehl entfernt das Add-In aus Exchange.

    Warnung

    Die Entfernung der Registrierung muss an alle Exchange-Server weitergegeben werden. Warten Sie mindestens drei Stunden, bevor Sie mit dem nächsten Schritt fortfahren.

  8. Fahren Sie mit dem Abschnitt Entfernen der Add-In-Artefakte fort.

Entfernen der Add-In-Artefakte

Wichtig

Führen Sie dieses Verfahren auf allen Geräten aus, auf denen das Add-In quergeladen wurde.

  1. Melden Sie sich von allen Office-Anwendungen ab, und schließen Sie sie dann alle, einschließlich Outlook.
  2. Löschen Sie den Office-Cache. Wenn das Ghost-Add-In Outlook unterstützt, verwenden Sie Den Cache in Outlook manuell löschen.
  3. Fahren Sie mit dem Abschnitt Entfernen der lokalen Registrierung fort.

Entfernen der lokalen Registrierung

Wichtig

Führen Sie dieses Verfahren auf allen Computern aus, auf denen das Add-In quergeladen wurde.

  1. Löschen Sie die lokale Registrierung des Ghost-Add-Ins. Der Prozess variiert je nach Betriebssystem.

    1. Öffnen Sie die Registrierungs-Editor.

    2. Navigieren Sie zu Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer. Dieser Schlüssel listet die Add-Ins auf, die derzeit quergeladen oder in der Vergangenheit quergeladen wurden und nicht vollständig deinstalliert wurden. Der Wert Data für jeden Eintrag ist der Pfad zum Manifest des Add-Ins. Der Name-Wert variiert je nachdem, welche Version des Tools zum Erstellen und Querladen des Add-Ins verwendet wurde. Wenn Visual Studio verwendet wurde, ist der Name in der Regel auch der Pfad zum Manifest. Bei anderen Tools ist der Name in der Regel die ID des Add-Ins. Wenn eine Office-Anwendung gestartet wird, lädt sie alle in diesem Schlüssel aufgeführten Add-Ins neu (die die Office-Anwendung unterstützen). Das Erneute Laden hat möglicherweise keine praktischen oder erkennbaren Auswirkungen, wenn die Artefakte des Add-Ins aus dem Cache gelöscht wurden, das Manifest nicht mehr im Pfad vorhanden ist oder die Dateien des Add-Ins nicht von einem Server bereitgestellt werden.

      Suchen Sie den Eintrag für das Ghost-Add-In, und löschen Sie ihn. Wenn es sich um ein Outlook-Add-In handelt, verfügen Sie über die ID zum Entfernen der Exchange-Registrierung. Sie können auch den Pfad in der Spalte Daten verwenden, um das Manifest zu suchen, um das Add-In zu identifizieren, auf das der Eintrag verweist, und die ID aus dem Manifest zu lesen. Wenn in der Spalte Daten aufgelistete Manifeste am angegebenen Pfad nicht mehr vorhanden sind, löschen Sie die Einträge für diese Manifeste.

      Die Windows-Registrierung für den Schlüssel namens Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer.

    3. Erweitern Sie ... Entwicklerknoten in der Registrierungsstruktur. Suchen Sie nach einem Unterschlüssel, dessen Name der ID des Ghost-Add-Ins entspricht. Wenn sie vorhanden ist, löschen Sie sie.

      Die Windows-Registrierung für den Schlüssel mit dem Namen Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer erweitert, um Unterschlüssel anzuzeigen.

    4. Navigieren Sie zu Computer\HKEY_USERS\{SID}\Software\Microsoft\Office\16.0\WEF\Developer, wobei {SID} die SID des Benutzers ist, mit dem Sie sich beim Querladen des Add-Ins angemeldet haben, und wiederholen Sie die beiden vorherigen Schritte.

    5. Navigieren Sie zu Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache. Suchen Sie in der Spalte Name nach allen Einträgen, die mit der ID des Add-Ins (eine GUID) beginnen, und löschen Sie sie. Navigieren Sie dann zu Computer\HKEY_USERS\{SID}\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache, wobei {SID} die SID des Benutzers ist, mit dem Sie beim Querladen des Add-Ins angemeldet waren, und wiederholen Sie den Vorgang.

      Die Windows-Registrierung für den Schlüssel namens Computer\HKEY_USERS\SID\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache**, wobei SID die SID eines Benutzers ist.

  1. Wenn Sie ein Outlook-Add-In entfernen, fahren Sie mit dem Abschnitt Testen auf Entfernen von Outlook-Add-Ins fort.

Testen zum Entfernen von Outlook-Add-Ins

Öffnen Sie Outlook mit derselben Identität, die Sie beim Erstellen des Add-Ins verwendet haben. Wenn Artefakte aus dem Add-In (z. B. benutzerdefinierte Menübandschaltflächen) nach einigen Minuten wieder angezeigt werden oder Wenn Ereignishandler aus dem Add-In aktiv zu sein scheinen, wurde die Entfernung der Registrierung des Add-Ins aus Exchange nicht an alle Exchange-Server weitergegeben. Warten Sie mindestens drei Stunden, und wiederholen Sie dann die Verfahren in den Abschnitten Entfernen der Add-In-Artefakte und Entfernen der lokalen Registrierung auf dem Computer, auf dem Sie die Artefakte beobachtet haben.

Weitere Informationen