Exchange Ressource Sync
Voraussetzung (häufige Fehlerquelle)
Für Ressourcen gilt besonders häufig:
- die E-Mail muss auf die primäre SMTP-Adresse der Ressourcenmailbox zeigen
EWS1,EWS2undO365benötigen eine gültige EWS.asmx-URLMicrosoft365benötigt keineSync-URL- verwechseln Sie
O365nicht mitMicrosoft365-O365ist weiterhin ein EWS-Modus
Voraussetzungen
Globale Parameter
Folgende Einstellungen müssen unter Einstellungen → System → Globale Parameter gesetzt sein:
| Parameter | Wert |
|---|---|
Exchange Ressource Sync enabled | true |
Legacy backSyncService
Für klassische Windows-Service-Setups mit EWS-Ressourcen-Sync wird zusätzlich weiterhin backSyncService verwendet:
<AddInstance
Key="backSyncService"
PluginType="Garaio.Products.Rooms.Core.WindowsServices.BaseServiceSession,Garaio.Products.Rooms.Core"
PluggedType="Garaio.Products.Rooms.Core.WindowsServices.BackSyncService.BackSyncServiceSession,Garaio.Products.Rooms.Core" />
Für Graph-Subscription-Management, EWS-Subscription-Management und andere bereits migrierte Hintergrundjobs ist dagegen keine separate pushSubscriberServiceSession-Aktivierung mehr nötig.
Ressource konfigurieren
Unter Einstellungen → Ressourcen → Bearbeiten werden die einzelnen Ressourcen für die Synchronisation eingerichtet:
| Feld | Beschreibung |
|---|---|
| muss auf die primäre SMTP-Adresse der Exchange-Ressource gesetzt werden | |
| Sync-Modus | EWS1, EWS2, O365 oder Microsoft365 |
| Sync-URL | nur bei EWS1, EWS2, O365 relevant |
| Ist Sync-Master | steuert das Verhalten bei Konflikten |
Ist Sync-Master
Falls eine Buchung in Exchange nicht für ROOMS verfügbar ist (z. B. wegen bestehender Buchung oder Sperrzeit), wird die ROOMS-Buchung nicht erstellt und eine Fehler-E-Mail versendet.
| Ist Sync-Master | Verhalten |
|---|---|
| Aktiviert | die Raumbuchung wird auch auf der Exchange-Seite entfernt bzw. der Teilnehmer wird aus der ROOMS-Buchung entfernt |
| Deaktiviert | der Termin bleibt in Exchange bestehen, es wird lediglich eine Fehler-E-Mail ausgelöst |
EWS vs Graph bei Ressourcen
EWS1,EWS2,O365synchronisieren Ressourcen über EWSMicrosoft365synchronisiert Ressourcen über Graph- Ressourcen laufen bei
Microsoft365praktisch app-basiert - ein Enduser-Consent-Flow wie bei Personen ist dafür nicht vorgesehen
Limitationen
Vor- und Nachlaufzeiten
Ist die Ressourcen-Sync auf einer Ressource aktiviert, können Vor- und Nachlaufzeiten nicht mehr verwendet werden. Bei allen Buchungen der Ressource werden die Vor- und Nachlaufzeiten auf 0 gesetzt, da Exchange dieses Konzept nicht unterstützt.| Einschränkung | Beschreibung |
|---|---|
| Nur eine Ressource pro Termin | Bei einem Outlook-Termin darf immer nur eine synchronisierte Ressource hinzugefügt oder eingeladen werden |
| Add-in: Ressource nicht manuell einladen | Wird über das Add-in eine synchronisierte Ressource gebucht, darf sie nicht zusätzlich als Teilnehmer hinzugefügt werden |
| Kein direkter Zugriff auf Exchange-Kalender | Termine sollen nicht direkt auf der Ressourcenmailbox erstellt werden; die Synchronisation ist auf den ROOMS-Flow ausgerichtet |
Es wird empfohlen, Benutzenden keinen direkten Zugriff auf die Exchange-Ressourcen-Mailboxen zu gewähren.
Buchungsrichtlinien der Exchange-Ressource (Booking Policies)
Exchange-Raumressourcen verarbeiten Buchungsanfragen automatisch (AutomateProcessing: AutoAccept). Die Ressource entscheidet anhand von Buchungsrichtlinien (Booking Policies), ob sie eine Anfrage annimmt oder ablehnt.
Wichtige Parameter
| Parameter | Beschreibung | Auswirkung auf Serien |
|---|---|---|
AllowRecurringMeetings | ob wiederkehrende Termine erlaubt sind | $false → alle Serien werden abgelehnt |
BookingWindowInDays | maximaler Buchungszeitraum in die Zukunft | Serie wird abgelehnt, wenn Termine ausserhalb des Fensters liegen |
EnforceSchedulingHorizon | ob BookingWindowInDays erzwungen wird | $true → Termine ausserhalb des Fensters werden abgelehnt |
MaximumConflictInstances | maximale Anzahl Konflikte in einer Serie | wird der Wert überschritten, lehnt Exchange die gesamte Serie ab |
ConflictPercentageAllowed | maximal erlaubter Konfliktanteil in % | Überschreitung → gesamte Serie wird abgelehnt |
MaximumDurationInMinutes | maximale Dauer eines einzelnen Termins | Einzeltermine über dem Limit werden abgelehnt |
Auswirkung auf Serien mit Konflikten
ROOMS kann Konflikte in einer Serie intern auflösen, z. B. durch Umbuchung einzelner Termine auf alternative Räume. Die Serie wird jedoch weiterhin an die Exchange-Ressource synchronisiert. Dort bestehen die Konflikte weiterhin auf Mailbox-Ebene.
Wichtig
WennMaximumConflictInstances oder ConflictPercentageAllowed auf 0 gesetzt sind (Standard), lehnt die Exchange-Ressource eine Serie komplett ab, sobald auch nur ein einziger Konflikt besteht - obwohl ROOMS die Konflikte intern bereits gelöst hat.Aktuelle Einstellungen auslesen
Connect-ExchangeOnline
Get-CalendarProcessing -Identity "raum@domain.ch" | Format-List
Einstellungen anpassen
Set-CalendarProcessing -Identity "raum@domain.ch" -MaximumConflictInstances 5 -ConflictPercentageAllowed 25