--- title: "📋 Outlook Add-In (klassisch): Rollout in Citrix Umgebung" url: "https://support.ftapi.com/de/article/outlook-add-in-klassisch-rollout-in-citrix-umgebung" language: "de" last_updated: "2026-08-13T13:17:26.804Z" --- # 📋 Outlook Add-In (klassisch): Rollout in Citrix Umgebung ## Rollout des Outlook Add-Ins (klassisch) unter Citrix Diese Anleitung beschreibt, wie Sie das FTAPI Outlook Add-In (klassisch) in einer Citrix-Umgebung (Session Hosts / VDAs) bereitstellen. Das Add-In wird dabei systemweit im Maschinenkontext installiert und unbeaufsichtigt (silent) ausgerollt. Die Vorgehensweise gilt sinngemäß auch für andere Terminalserver-Umgebungen (z. B. Microsoft Terminal Server). ## Systemvoraussetzungen Auf jedem Session Host bzw. im Golden Image müssen folgende Voraussetzungen erfüllt sein: - 64-Bit-Betriebssystem (32-Bit wird nicht mehr unterstützt) - Klassisches Outlook 2016 oder neuer (nicht das „neue" Outlook) - .NET Framework 4.8 oder höher - VSTO 2010 Runtime - WebView2 Runtime Für die automatisierte Verteilung wird der **Small\_Installer** verwendet. Dieser enthält **nur** das Add-In und setzt voraus, dass .NET 4.8, die VSTO 2010 Runtime und die WebView2 Runtime bereits installiert sind. Nehmen Sie diese drei Komponenten daher fest in Ihr Golden Image bzw. Ihren OS-/Platform-Layer auf. ## Systemweite Installation (Silent) Führen Sie die Installation des Outlook Add-Ins systemweit für „Alle Benutzer" durch (`ALLUSERS="1"`). Verwenden Sie hierfür zwingend den Small\_Installer. **Empfohlener Rollout-Befehl (mit Vorkonfiguration):** ```batch msiexec /i "FTAPI_Outlook_AddIn_Small.msi" SERVER="subdomain.domain.com" ALLUSERS="1" USEFTAPI="Y" SECURITYLEVEL="2" HIDESENDWITHFTAPIBUTTON="Y" HIDEINSERTDOWNLOADBUTTON="Y" DEFAULTDOWNLOADBUTTONLOCATION="Middle" HIDESUBMITBOXBUTTON="Y" HIDEDAYSVALIDINPUT="Y" SUPPRESSFORMATTINGWARNING="Y" ARCHIVEUPLOADEDATTACHMENTMAXSIZEMB="20" ARCHIVEDOWNLOADEDATTACHMENTMAXSIZEMB="20" DECRYPTSENTMESSAGE="Y" /qn /norestart /l*v "%TEMP%\FTAPI_AddIn_Install.log" ``` Die wichtigsten Parameter: - `SERVER`: URL Ihres FTAPI-Servers (ohne `https://`) - `ALLUSERS="1"`: Installation im Maschinenkontext (systemweit) – zwingend für Terminalserver - `/qn`: Installation ohne Oberfläche (silent) - `/norestart`: kein automatischer Neustart - `/l*v "…log"`: ausführliches Logging (empfohlen) Dadurch werden unter folgendem Pfad die Registry-Keys erzeugt: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Outlook\Addins\FTAPI Outlook Add-In` > **Hinweis für Terminalserver:** Aktivieren Sie auf RDS/Session-Hosts vor der Installation den Installationsmodus (`change user /install`) und stellen Sie ihn danach wieder her (`change user /execute`). Bei der Bearbeitung eines Master-Images (MCS/PVS) entfällt dieser Schritt. Outlook muss während der Installation geschlossen sein. ## Verteilwege ### Golden Image / Master (MCS oder PVS) 1. Master-VM in den Wartungsmodus versetzen, Outlook schließen. 2. Voraussetzungen installieren: .NET 4.8, VSTO 2010 Runtime, WebView2 Runtime. 3. Add-In per Small\_Installer silent installieren (siehe oben). 4. Mit einem Testbenutzer prüfen, dass das Add-In lädt. 5. Image versiegeln und via MCS/PVS an die Session Hosts verteilen. ### Citrix App Layering 1. Voraussetzungen (.NET 4.8, VSTO, WebView2) in den OS- bzw. Platform-Layer aufnehmen. 2. Im App-Layer (Packaging Machine): Outlook schließen, Add-In per Small\_Installer silent installieren. 3. Layer finalisieren und dem Image-Template zuweisen. ### Softwareverteilung (SCCM / Intune o. ä.) 1. Small\_Installer und Voraussetzungspakete als Anwendung anlegen. 2. Als Installationskommando den Rollout-Befehl (eine Zeile, `/qn /norestart`) hinterlegen. 3. Abhängigkeiten definieren: .NET 4.8 → VSTO → WebView2 → Add-In. 4. Deployment als Maschinenzuweisung auf die Session Hosts ausrollen. ## Deaktivierung für bestimmte Nutzer Da das Add-In systemweit installiert ist, ist es zunächst für alle Nutzer aktiv. Für alle Nutzer, welche das Outlook Add-In **nicht** erhalten sollen, rollen Sie bitte manuell oder per GPO den folgenden Ordner im Benutzerkontext aus: `HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\Addins\FTAPI Outlook Add-In` In diesem neuen Schlüssel setzen Sie zwingend die folgenden Werte: - DWORD-Wert (32bit); Name: `LoadBehavior`; Wert=`0` - Zeichenfolge; Name: `Description`; Wert=`FTAPI Outlook Add-In` - Zeichenfolge; Name: `FriendlyName`; Wert=`FTAPI Outlook Add-In` - Zeichenfolge; Name: `Manifest`; Wert=`C:\Program Files (x86)\FTAPI\Outlook Add-In\FTAPIOutlookAddin2013.vsto|vstolocal` **Das Outlook Add-In verhält sich nun wie folgt:** - Nutzer, welche den Eintrag `LoadBehavior` unter `HKEY_CURRENT_USER` **nicht** haben: Add-In startet regulär mit Outlook. - Nutzer, welche den Eintrag unter `HKEY_CURRENT_USER` **gesetzt** haben (Wert 0): Add-In startet nicht. In Citrix bietet es sich an, diesen Eintrag gezielt per GPO-Preference (Registry, Item-Level-Targeting auf eine AD-Gruppe) oder per Logon-Skript zu setzen. > **Wichtig: Bitte beachten Sie, dass Sie den LoadBehavior-Schlüssel nach einem Versions-Update des Add-Ins gegebenenfalls erneut löschen bzw. korrigieren müssen.** ## Nachträgliches Ändern der Einstellungen (user.config) Möglicherweise ist es notwendig, die Einstellungen der initialen Installation nachträglich anzupassen. Die Konfigurationsdatei `user.config` wird nach dem ersten Start von Outlook im lokalen Roamingprofil des Anwenders erstellt: `C:\Users\\AppData\Roaming\FTAPI\Outlook Add-In\user.config` Die Datei ist im XML-Format gehalten und pro Einstellung folgendermaßen aufgebaut: ```xml Wert der Einstellung ``` ### Praxis-Beispiel: Archivierungslimit anpassen Sie möchten die Dateigröße, bis zu der Dateien nach dem Versand der E-Mail automatisch archiviert werden sollen, von 5 auf 10 MB ändern. 1. Öffnen Sie die Datei `user.config` eines Test-Profils. 2. Suchen Sie nach der Einstellung `ArchiveDownloadedAttachmentMaxSizeMB`. 3. Ändern Sie den Wert von `5` auf `10`. 4. Speichern Sie die XML-Datei. Die angepasste Datei lässt sich anschließend über eine Gruppenrichtlinie (GPO File Preference) zentral an verschiedene Anwender verteilen. Da `user.config` im Roamingprofil (`AppData\Roaming`) liegt, wird sie bei aktivierten Roaming-/FSLogix-Profilen automatisch pro Benutzer mitgeführt. ## **Ähnliche Artikel** > #### [**📋 Outlook Add-In (klassisch): Downloads & Systemvoraussetzungen**](https://support.ftapi.com/de/article/-outlook-add-in-downloads-systemvoraussetzungen) > #### [**📋 Outlook Add-In (klassisch): Installationsparameter für Administratoren**](https://support.ftapi.com/de/article/outlook-add-in-installationsparameter) > #### [**📋 Outlook Add-In (klassisch): Konfiguration für Terminalserver und Mehrbenutzer**](https://support.ftapi.com/de/article/outlook-add-in-klassisch-konfiguration-fur-terminalserver-und-mehrbenutzer)