Microsoft 365 und Exchange Server

Exchange Category Manager installieren

Wählen Sie Ihre Umgebung. Beide Installationsarten verwenden dasselbe CATMAN_GRAPH.zip-Paket.

CATMAN_GRAPH.zip herunterladen Installationshilfe anfragen

Microsoft 365

Microsoft 365 / Graph installieren

Geschätzte Installationszeit: etwa drei Minuten, wenn Administratorzugriff und Postfach bereitstehen.

Vorbereitung

Ein Windows-Computer oder -Server, der während der Kategorienverwaltung eingeschaltet bleibt.
Ein Benutzer mit Microsoft Entra-Zugriff und Kenntnis der Microsoft 365-Tenant-ID.
Ein Microsoft 365-Postfach für Validierung und Lizenzverwaltung.

1. Herunterladen und entpacken

Laden Sie CATMAN_GRAPH.zip herunter und entpacken Sie es in einen beschreibbaren Ordner wie C:\CATMAN_GRAPH. Installieren Sie nicht unter Program Files, da CATMAN Konfigurations- und Protokolldateien im eigenen Ordner speichert.

2. CATMAN-Administrationspostfach wählen

Erstellen oder wählen Sie ein Microsoft 365-Postfach für Validierung und Lizenzverwaltung. Ein eigenes Postfach mit dem Namen CatManAdmin wird empfohlen.

3. Ältere Installation migrieren

Stoppen Sie den vorhandenen CATMAN-Dienst und kopieren Sie config.ini in den neuen Stammordner. Benutzer, Kategorielisten und unterstützte Einstellungen werden soweit möglich übernommen.

4. catadmin_graph.exe starten

Starten Sie catadmin_graph.exe und wählen Sie Microsoft 365.

5. CATMAN in Microsoft Entra registrieren

Geben Sie die Tenant-ID ein und wählen Sie Register app in Azure. CATMAN öffnet ein erhöhtes PowerShell-Fenster, um die App-Registrierung und erforderlichen Microsoft Graph-Berechtigungen einzurichten.

6. Postfach validieren

Geben Sie die Adresse des CATMAN-Administrationspostfachs ein und wählen Sie Validate. Wird die neue Registrierung noch nicht akzeptiert, warten Sie eine Minute und validieren Sie erneut.

7. Erste Testliste erstellen

Fügen Sie einen Benutzer und eine Kategorieliste mit einer Kategorie hinzu. Wählen Sie Benutzer und Liste und klicken Sie auf Configure selected users with the selected category list.

8. Dienst installieren und starten

Wählen Sie Install service und anschließend Start service. Prüfen Sie in Outlook, ob die Kategorie beim Testbenutzer erscheint.

Nach dem ersten Test

Fügen Sie Benutzer manuell, aus der GAL oder per Verteilerliste hinzu.
Erstellen Sie die benötigten Kategorielisten.
Ordnen Sie Benutzer und Teams der richtigen Liste zu.
Nutzen Sie Protokoll und Support bei unerwartetem Verhalten.

Lokal

Exchange Server installieren

Verwenden Sie den Exchange Server-Modus nur für eine lokale Exchange-Umgebung. Dasselbe CATMAN_GRAPH.zip-Paket wird verwendet.

Vorbereitung

Ein Windows-Computer oder -Server, der online bleibt.
Ein Exchange-Postfach für das CATMAN-Administratorkonto.
Berechtigung zum Konfigurieren von Application Impersonation.
Der Exchange-EWS-Endpunkt, sofern Autodiscover ihn nicht findet.

1. Administratorkonto erstellen

Erstellen Sie in Active Directory einen Benutzer, z. B. CatManAdmin, und weisen Sie ihm ein Exchange-Postfach zu. Die Mitgliedschaft in Domain Users ist ausreichend.

2. Impersonation-Rechte zuweisen

New-ManagementRoleAssignment -Name:CatManimpersonation -Role:ApplicationImpersonation -User:CatManAdmin

3. Herunterladen und entpacken

Entpacken Sie CATMAN_GRAPH.zip in einen beschreibbaren Ordner auf einem 64-Bit-Windows-Computer oder -Server.

4. Starten und validieren

Starten Sie catadmin_graph.exe, wählen Sie Exchange server, geben Sie E-Mail-Adresse und Kennwort ein und wählen Sie Validate.

Wenn Autodiscover EWS nicht findet, geben Sie den Endpunkt manuell ein:

https://exchange.firma.de/EWS/Exchange.asmx

5. Benutzer und Listen hinzufügen

Fügen Sie die Exchange-Postfächer hinzu, erstellen Sie die benötigten Listen und ordnen Sie Benutzer zu.

6. Dienst installieren und starten

Wählen Sie Install service und Start service. Prüfen Sie Outlook und öffnen Sie mit Open log das Diagnoseprotokoll.

Referenz

Einstellungen der CATMAN-Konsole

Ersteinrichtung

Tenant ID: Microsoft Entra-Tenant-ID für Microsoft 365.
Register / unregister app: Erstellt oder entfernt die CATMAN-App-Registrierung.
CATMAN admin: Postfach für Validierung, Lizenz und Verwaltung.
Validate: Prüft den Zugriff auf Postfach und Umgebung.
EWS endpoint: Lokaler Exchange Web Services-Endpunkt.

Dienststeuerung

Install / uninstall service: Installiert oder entfernt den Hintergrunddienst.
Start / stop / restart: Steuert die Hintergrundverarbeitung.
Run every: Legt das Prüfintervall fest.
Process now: Fordert eine sofortige Verarbeitung an.
Open log: Öffnet das Diagnoseprotokoll.

Benutzer und Listen

Add users: Fügt Postfächer manuell, aus der GAL oder per Verteilerliste hinzu.
Make / rename list: Erstellt oder benennt eine zentrale Kategorieliste um.
Configure selected users: Ordnet ausgewählte Benutzer einer Liste zu.
Remove from list: Entfernt die Zuordnung eines Benutzers oder einer Gruppe.

Kategorieverwaltung

Add / edit: Erstellt oder ändert Kategoriename und -farbe.
Delete / restore: Markiert eine Kategorie zum Löschen oder stellt sie wieder her.
Delete unmanaged categories: Entfernt optional Kategorien außerhalb der verwalteten Liste.

Erweitert

Zusätzliche config.ini-Optionen

Manueller EWS-Endpunkt

[Override]
ManualURL=https://exchange.firma.de/EWS/Exchange.asmx

Microsoft 365-Tenant

[OAuth]
TenantID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

Vorhandene Installationen

Kopieren Sie die alte config.ini in den neuen Softwareordner, bevor Sie die Konsole starten.

Protokolle und Lizenzen

Konsole und Dienst schreiben Protokolldateien in den Softwareordner. Test- und Kaufversion verwenden dasselbe Paket; Lizenzen werden automatisch über das Administrationspostfach verarbeitet.