📋 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):

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\<Benutzername>\AppData\Roaming\FTAPI\Outlook Add-In\user.config

Die Datei ist im XML-Format gehalten und pro Einstellung folgendermaßen aufgebaut:

<Setting name="Name der Einstellung" serializeAs="String">
  <value>Wert der Einstellung</value>
</Setting>

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

📋 Outlook Add-In (klassisch): Installationsparameter für Administratoren

📋 Outlook Add-In (klassisch): Konfiguration für Terminalserver und Mehrbenutzer