Exchange Group Calendar Installation
Verwenden Sie die Graph-Version für Microsoft 365 / Office 365. Die EWS-Version ist nur für On-Prem Exchange gedacht.
Office 365 / Microsoft 365 Installation
Geschätzte Installationszeit: 3 Minuten. Verwenden Sie EGC_GRAPH.zip für Microsoft 365 / Office 365.
Bevor Sie beginnen
Für eine Microsoft 365-Installation sollten diese drei Dinge verfügbar sein.
- Ein Windows-Computer oder Server, der während der Bürozeiten eingeschaltet ist, plus jemand, der dort Software installieren darf.
- Ein Benutzer mit Zugriff auf Entra / Azure, der die Microsoft Tenant ID kennt.
- Ein Microsoft 365-Postfach, das ausschließlich von EGC zum Hosten der Gruppenkalender verwendet werden kann.
Herunterladen und entpacken
Laden Sie EGC_GRAPH.zip herunter und entpacken Sie es in einen normalen beschreibbaren Ordner, zum Beispiel C:\EGC_GRAPH oder D:\EGC_GRAPH. Verwenden Sie nicht Program Files, da EGC Schreibzugriff auf Unterordner benötigt.
GCADMIN-Postfach erstellen oder wiederverwenden
Erstellen Sie bei einer neuen Installation ein dediziertes Microsoft 365-Postfach in der Office 365 Admin-Konsole. Eine normale Microsoft 365-Lizenz ist erforderlich. Wir empfehlen GCADMIN als Benutzernamen. Die Gruppenkalender werden unter dem Standard-Outlook-Kalender dieses Postfachs abgelegt.
Ältere Installation migrieren
Wenn Sie Exchange Group Calendar bereits verwenden, stoppen Sie zuerst den bestehenden EGC-Dienst und kopieren Sie die vorhandene config.ini in den Stammordner von EGC_GRAPH. Die vorhandene Konfiguration wird automatisch verwendet.
gcadmin.exe starten
Starten Sie gcadmin.exe. Sie können später eine Verknüpfung auf dem Desktop oder im Startmenü erstellen.
EGC in Entra / Azure registrieren
Geben Sie die Tenant ID des Kunden ein und verwenden Sie die Registrierungsschaltfläche in GCADMIN. Dadurch wird die EGC App Registration im Microsoft-Tenant des Kunden erstellt und die erforderlichen Graph-Berechtigungen werden gewährt.
GCADMIN-Postfach validieren
Geben Sie die E-Mail-Adresse des GCADMIN-Postfachs ein und klicken Sie auf Validate. EGC prüft, ob es auf das Postfach zugreifen, den Kalender öffnen, ein Testelement erstellen und wieder entfernen kann.
Ersten Test-Gruppenkalender erstellen
Nach Tenant-Registrierung und Postfachvalidierung werden die weiteren Optionen aktiv. Für einen Basistest fügen Sie einen Gruppenkalender und eine Benutzeradresse hinzu. Wählen Sie beide aus und klicken Sie auf Make member.
Berechtigungen und Filter einstellen
Wählen Sie den Gruppenkalender aus und konfigurieren Sie, ob er standardmäßig versteckt oder sichtbar ist, wer ihn sehen darf, wer Administratorrechte hat und welche Outlook-Elemente aufgenommen werden sollen.
Dienst installieren und starten
Klicken Sie auf Install Service und danach auf Start Service. Öffnen Sie Outlook, prüfen Sie, ob der Gruppenkalender sichtbar ist, fügen Sie einige Elemente in Ihrem persönlichen Kalender hinzu und prüfen Sie, ob sie in den Gruppenkalender kopiert werden.
Übersicht der Einstellungen in der GCADMIN-Konsole
Diese Einstellungen umfassen Einrichtung, Dienststeuerung, Gruppenkalender, Benutzer, Berechtigungen, Filter, Datenschutz, Import und Kategorien.
Initial setup
- Tenant ID
- Die Microsoft Entra/Azure Tenant ID der Kundenumgebung.
- Register EGC in Entra/Azure
- Erstellt die EGC App Registration im Microsoft-Tenant des Kunden und gewährt die erforderlichen Graph-Berechtigungen.
- Remove EGC Azure registration
- Entfernt die EGC App Registration, wenn ein Kunde bereinigen oder neu beginnen möchte.
- GC admin email address
- Das lizenzierte Postfach, das die Gruppenkalender hostet.
- Validate gcadmin
- Prüft, ob EGC auf das GCADMIN-Postfach zugreifen, den Kalender öffnen, ein Testelement erstellen und wieder entfernen kann.
Support und Dienst
- Buy license
- Öffnet die EGC-Lizenzkaufseite.
- Open log
- Öffnet das aktuelle EGC-Dienstprotokoll für Support und Diagnose.
- Chat with support
- Öffnet Live-Support direkt aus der Konsole.
- Install service
- Installiert den EGC-GRAPH Windows-Dienst.
- Start / Stop / Restart
- Steuert den Hintergrunddienst.
- Uninstall
- Entfernt die Windows-Dienstregistrierung.
Gruppenkalender und Benutzer
- Group calendars
- Die freigegebenen Outlook-Kalenderordner, die EGC verwaltet.
- Add groupcalendar
- Erstellt einen neuen Gruppenkalender unter dem GCADMIN-Postfach.
- Delete selected
- Löscht den ausgewählten Gruppenkalenderordner und bereinigt die Konfiguration.
- Purge
- Leert ausgewählte Gruppenkalender, ohne Benutzerkalender zu ändern.
- Users
- Die Postfächer, die EGC scannen und synchronisieren darf.
- Add user(s)
- Fügt Benutzer manuell, aus der GAL oder per Verteilerliste hinzu. Benutzer können auch eine zweite kurze E-Mail-Adresse haben.
- Delete selected
- Entfernt ausgewählte Benutzer aus der EGC-Konfiguration.
- Make selected user(s) member of selected groupcalendar(s)
- Fügt ausgewählte Benutzer ausgewählten Gruppenkalendern hinzu.
- Remove selected member(s) from selected groupcalendar
- Entfernt ausgewählte Mitglieder aus dem ausgewählten Gruppenkalender.
- Members of selected groupcalendar
- Zeigt, wessen Kalendereinträge in den ausgewählten Gruppenkalender kopiert werden dürfen.
Berechtigungen
- Groupcalendar hidden
- Normale Benutzer sehen den Kalender nicht, es sei denn, sie wurden explizit berechtigt.
- Groupcalendar visible
- Normale Benutzer können den Gruppenkalender öffnen und lesen.
- Groupcalendar visible list
- Wählt Benutzer aus, die einen versteckten Gruppenkalender sehen dürfen.
- Admins
- Wählt Benutzer aus, die Elemente im Gruppenkalender erstellen, ändern und löschen dürfen.
- Load all users
- Erweitert die Berechtigungsliste über die aktuellen Mitglieder hinaus.
- Save permissions
- Schreibt die ausgewählten Berechtigungen direkt in Outlook/Graph-Ordnerberechtigungen.
Filter
- Text / category filters
- Steuert, welche Elemente anhand von Betreff, Text oder Outlook-Kategorie aufgenommen werden.
- Mode
- Wählen Sie keinen Filter, nur passende Elemente anzeigen oder passende Elemente ausblenden.
- Subject contains
- Sucht Wörter im Betreff des Termins.
- Body contains
- Sucht Wörter im Text des Termins.
- Categories
- Sucht exakte Outlook-Kategorienamen.
- Busy / OOF / Working elsewhere / OOF + Else
- Nimmt nur Elemente mit dem gewählten Outlook-Verfügbarkeitsstatus auf.
- Hide free time
- Schließt als frei markierte Elemente aus.
- Result
- Zeigt in Klartext, was die aktuelle Filterkombination bewirkt.
- Show subject only
- Kopiert nur den Betreff, nicht alle Details.
- Hide body text
- Entfernt den Text aus Kopien im Gruppenkalender.
- Include domain attendees
- Nimmt Meetings immer auf, wenn ausgewählte Personen oder Domains eingeladen sind.
- Open domain attendee list
- Öffnet die E-Mail-/Domainliste für den Teilnehmerfilter.
Erweiterte Einstellungen
- Moderators
- Sendet E-Mail-Benachrichtigungen an ausgewählte Moderatoren, wenn neue Elemente erscheinen.
- Meeting prefix
- Legt das Wort fest, mit dem EGC Meetings in Gruppenkalender-Betreffzeilen markiert.
- Disable 2-way sync
- Kopiert Benutzerkalendereinträge in den Gruppenkalender, ignoriert aber Änderungen im Gruppenkalender.
- Process future only
- Verarbeitet nur Elemente, die in der Zukunft beginnen.
- User subfolder name
- Verwendet, sofern vorhanden, einen benannten Kalenderunterordner statt des Standardkalenders des Benutzers.
- Remove items older than 60 days
- Bereinigt alte Gruppenkalendereinträge, um Outlook schneller zu halten.
- Use user timezone
- Hilft, wenn Benutzerkalender in einer anderen Zeitzone liegen als der Server.
- Log files
- Legt fest, wie viele Logdateien aufbewahrt werden.
- Save settings
- Speichert Gruppenkalendereinstellungen.
Datenschutz, Import und Kategorien
- Do nothing
- Behandelt private Outlook-Elemente wie normale Elemente.
- Hide
- Kopiert private Elemente nicht in Gruppenkalender.
- Hide details and change subject into
- Zeigt, dass der Benutzer beschäftigt ist, verbirgt aber die Details.
- Import
- Baut Gruppenkalenderinhalte aus bestehenden Benutzerkalendern neu auf.
- Days past / Days future
- Definiert den Datumsbereich für den Import.
- Start import / Stop import
- Startet oder stoppt einen Importauftrag.
- Category management
- Definiert Outlook-Kategorien und Farben für EGC.
- Add / Edit / Delete
- Verwaltet EGC-Kategoriedefinitionen.
- Delete all categories but defined list
- Ersetzt die Outlook-Kategorien der Benutzer durch die verwaltete EGC-Kategorieliste.
On-prem Exchange Server Installation
Verwenden Sie die EWS-Version nur für lokale Exchange-Umgebungen. Fordern Sie EGC_EWS.zip per E-Mail an.
GCADMIN-Konto erstellen
Erstellen Sie einen neuen Benutzer in Active Directory, zum Beispiel GCadmin, und weisen Sie ihm ein Postfach zu. Mitgliedschaft in Domain Users reicht aus. Prüfen Sie in der Exchange Management Console die Register Account und Email Addresses. Die primäre E-Mail-Adresse von GCADMIN muss in der lokalen Domäne liegen, falls diese von der Internetdomäne abweicht.
Impersonation-Berechtigung zuweisen
Führen Sie diesen Befehl in der Exchange Management Shell aus:
New-ManagementRoleAssignment -Name:EGCimpersonation -Role:ApplicationImpersonation -User:gcadmin
Software herunterladen und entpacken
Fordern Sie EGC_EWS.zip an. Nachdem Sie die ZIP-Datei per E-Mail erhalten haben, entpacken Sie sie auf einem 64-Bit-Windows-Computer oder Server, der eingeschaltet bleibt, während Exchange verwendet wird. Fordern Sie eine Testlizenz an; die EWS-Version funktioniert nicht ohne Lizenz.
Verbindung testen
Starten Sie GCADMIN.EXE, geben Sie E-Mail-Adresse und Passwort des GCADMIN-Kontos ein und klicken Sie auf Test Credentials. Die Statusausgabe unten in der Konsole sollte eine erfolgreiche Anmeldung an Exchange anzeigen.
Gruppenkalenderordner erstellen
Erstellen Sie einen oder mehrere Kalenderordner im Public-Folders-Bereich von Microsoft Outlook. Falls Public Folders noch nicht verfügbar sind, erstellen Sie zuerst einen Public Folder tree. Verwenden Sie Outlook, nicht Exchange Management Console oder Exchange Shell, weil diese Tools Mailordner erstellen. Drücken Sie in Outlook CTRL + 6, suchen Sie Public Folders, erstellen Sie einen neuen Ordner und wählen Sie Contains Calendar Items.
Public-Folder-Berechtigungen setzen
Öffnen Sie die Berechtigungen des neuen Gruppenkalenders. Fügen Sie GCADMIN als Owner hinzu. Administratoren sollten ebenfalls Owner sein. Normale Benutzer benötigen meist Author-Berechtigungen. Um den Kalender für einen Benutzer zu verstecken, fügen Sie den Benutzer hinzu und entfernen Sie Folder Visible. Klicken Sie mit der rechten Maustaste auf den Kalender und fügen Sie ihn zu Favorites hinzu, damit er im normalen Outlook-Kalenderbereich erscheint.
Gruppenkalender und Benutzer hinzufügen
Fügen Sie in GCADMIN.EXE Gruppenkalender mit diesem Pfadformat hinzu:
/folder/subfolder/subsubfolder
Der erste Slash steht für die Ebene unter Public Folders / All Public Folders. Beispiel: Public Folders / All Public Folders / groupcal wird zu /groupcal. Fügen Sie alle Benutzer-E-Mail-Adressen hinzu, deren Kalender synchronisiert werden sollen. Benutzer, die einen Gruppenkalender nur anzeigen, müssen nicht in der Benutzerliste stehen.
Benutzer Gruppenkalendern zuweisen
Ein Benutzer kann Mitglied eines oder mehrerer Gruppenkalender sein. Mitgliedschaft bedeutet, dass persönliche Kalendereinträge in den Gruppenkalender repliziert werden können und Gruppenkalendereinträge ggf. zurück in den Benutzerkalender. Wählen Sie Benutzer und Gruppenkalender aus und klicken Sie auf die Schaltfläche, um den Benutzer zum Mitglied zu machen.
Primary Group Calendar
Wenn Sie die Primary-Group-Calendar-Funktion verwenden, markieren Sie in der Mitgliederliste des Gruppenkalenders die Checkbox, um den ausgewählten Gruppenkalender als Primary Group Calendar des Benutzers festzulegen.
Dienst installieren
Bearbeiten Sie RunEGCasService.ini im Ordner, in dem die Software entpackt wurde. Stellen Sie sicher, dass CommandLine und WorkingDir zum Installationsordner passen.
CommandLine = C:\GroupCalendar\ExchangeGroupCalendar_EWS.exe WorkingDir = C:\GroupCalendar
Führen Sie InstallService.bat aus. Wenn ein Fehler erscheint, starten Sie die Datei aus einer erhöhten Eingabeaufforderung, nachdem Sie in den Installationsordner gewechselt sind.
Logging aktivieren und Betrieb prüfen
Aktivieren Sie in GCADMIN das Logging in eine Textdatei. Öffnen Sie egclog1.txt, nachdem der EGC-Dienst gestartet wurde. Prüfen Sie, ob die Lizenz funktioniert, die Exchange-Verbindung funktioniert und keine Berechtigungsprobleme bestehen. Wenn keine Meldungen mit error, exception oder problem erscheinen, funktioniert alles wie erwartet.
Zusätzliche Konfiguration in config.ini
Diese Optionen sind vor allem für größere oder lokale Installationen gedacht, bei denen die Konfiguration manuell oder per Skript verwaltet wird.
Benutzer massenhaft importieren
- Benutzer aus Exchange exportieren
- Sie können config.ini manuell oder per Skript bearbeiten. Verwenden Sie den untenstehenden Exchange-Shell-Befehl, um alle E-Mail-Adressen zu exportieren, und senden Sie die Liste zusammen mit config.ini an den Support, oder erstellen Sie selbst eine nummerierte Liste in Excel.
Bestehende Kalendereinträge importieren
- [Import]
- Setzen Sie ImportNow=True und definieren Sie PastDays, FutureDays und optional Users, um Gruppenkalenderinhalte aus bestehenden Benutzerkalendern neu aufzubauen. Wenn Users leer ist, werden Einträge aller Benutzer importiert.
Bereinigung
- [CleanUp]
- Standardmäßig werden Elemente, die älter als 60 Tage sind, aus Gruppenkalendern entfernt. Setzen Sie RemoveOlderThan60Days=False, um dies zu deaktivieren.
Zweites GCADMIN-Konto
- [GCAMIN2]
- Für Office 365 EWS-Installationen mit mehr als 20 Gruppenkalendern kann ein zweites GCADMIN-Konto erforderlich sein. Korrigieren Sie die Schreibweise GCAMIN2 nicht.
Kalenderunterordner pro Benutzer
- [UseSubFolderCalendar]
- FolderName=MySubfolder erstellt und verwendet einen Unterkalender unter dem Standard-Outlook-Kalender jedes Benutzers.
Zeitzone und nur zukünftige Elemente
- [TimeZone]
- UseUserTimeZone=True verwendet die Zeitzone des Benutzers.
- [ProcessFutureOnly]
- Value=True verarbeitet nur Elemente, die in der Zukunft beginnen.
Passwort verschlüsseln
- [EncryptPassword]
- Setzen Sie Value=True, speichern Sie config.ini, öffnen Sie gcadmin.exe, geben Sie das Passwort erneut ein und klicken Sie aus dem Passwortfeld heraus. Das Passwort wird durch ****** ersetzt.
GCADMIN-Kalender als Root für Gruppenkalender verwenden
- [GcadminCalendarIsGcroot]
- Setzen Sie Value=True, wenn Sie keine Public Folders verwenden möchten. Die Software verwendet dann den Standard-Calendar-Ordner im GCADMIN-Postfach als Root. Verwenden Sie /foldername beim Hinzufügen eines Gruppenkalenders.
Beispiel-Einstellungen
Get-Mailbox -ResultSize Unlimited | Select-Object DisplayName,ServerName,PrimarySmtpAddress, @{Name="EmailAddresses";Expression={$_.EmailAddresses | Where-Object {$_.PrefixString -ceq "smtp"} | ForEach-Object {$_.SmtpAddress}}} > c:\temp\export.txt
[Import]
ImportNow=True
PastDays=30
FutureDays=30
Users=a@b.com;c@b.com;d@b.com
[CleanUp]
RemoveOlderThan60Days=False
[GCAMIN2]
EmailAddress=
Password=
[UseSubFolderCalendar]
FolderName=MySubfolder
[TimeZone]
UseUserTimeZone=True
[ProcessFutureOnly]
Value=True
[EncryptPassword]
Value=True
[GcadminCalendarIsGcroot]
Value=True