Integration von Microsoft Exchange 2010-2019

Die folgende Konfiguration von Exchange 2010-2019 ist erforderlich, damit GoBright mit den Kalendern in Exchange kommunizieren kann.

1. Voraussetzungen

  • Die minimal erforderliche Exchange Server-Version:
    • Exchange Server 2010 Version 14.3.468.0(Rollup 29 SP3 - 9. Juli 2019)
    • Exchange Server 2013
    • Exchange Server 2016
    • Exchange Server 2019
  • Administratorzugriff auf die Exchange-Umgebung
  • Zugriff auf die Exchange Management Shell
  • De EWS sollte von außen zugänglich sein, dies ist wahrscheinlich der Fall, wenn das Webmail (OWA) von außen zugänglich ist.
  • Der Exchange-Server sollte in der Lage sein, Push-Benachrichtigungen (Web-Hooks, einfache HTTPS-Aufrufe) an https://*.brightbooking.eu & https://*.gobright.com & https://*.gobright.cloud (Port 443) zu senden.

Das Konfigurationshandbuch führt Sie durch die folgenden Schritte:

  • Starten Sie die Exchange Management Shell
  • Erstellen eines Dienstkontos in Exchange
  • Erstellen Sie die Raumkalender in Exchange
  • Erlauben Sie dem Dienstkonto den Zugang zu den Raumpostfächern
  • Erstellen einer "Raumliste" in Exchange
  • Konfigurieren Sie den Standardzugang der Benutzer zu den Raumpostfächern
  • Konfigurieren Sie das Verhalten der Raum-Mailboxen
  • Finden Sie die FWS-Adresse

2. Starten Sie die Exchange Management Shell

Der einfachste Weg, die verschiedenen Konfigurationsbefehle auszuführen, ist die Verbindung mit der Exchange Management Shell.

Melden Sie sich an Ihrem Exchange-Server an und starten Sie die Exchange Management Shell über das Startmenü:

  • Start > Microsoft Exchange Server 2007/2010/2013/2016/2019 > Exchange Management Shell

3. Erstellen Sie ein Dienstkonto in Exchange

3.1 Einrichtung eines Dienstkontos:

GoBright benötigt ein Dienstkonto, um Zugang zu den Kalendern zu erhalten, um die Raumkalender synchronisieren zu können.

Führen Sie die folgenden Befehle über die Exchange Management Shell aus.

Führen Sie nun den folgenden Befehl aus, um das Dienstkonto zu erstellen. Ändern Sie den UserPrincipalName in Ihren eigenen Namen/Domain und YourPasswordHere in das Passwort, das Sie für das Dienstkonto verwenden möchten:

New-Mailbox -UserPrincipalName [email protected] -Alias 'GoBright' -Name GoBright-Password (ConvertTo-SecureString -String YourPasswordHere -AsPlainText -Force) -FirstName 'GoBright' -DisplayName 'GoBright' -ResetPasswordOnNextLogon $false

Bei Bedarf können Sie mit dem Parameter -Database eine bestimmte "Exchange-Datenbank" und mit dem Parameter -OrganizationalUnit die Organisationseinheit festlegen. Der obige Beispielbefehl geht von der Standard-Exchange-Datenbank und -Organisationseinheit aus.

Überprüfen Sie nun, ob das Dienstkonto korrekt erstellt wurde, indem Sie den folgenden Befehl ausführen. Das Ergebnis des Befehls sollte die Mailbox des neu erstellten Dienstkontos anzeigen. Wenn keine Mailbox angezeigt wird, sollten Sie wahrscheinlich eine Lizenz mit der Mailbox im Office Admin Center verknüpfen. Führen Sie den folgenden Befehl aus und ersetzen Sie den Parameter Identity durch die E-Mail-Adresse des Dienstkontos:

Get-Mailbox -Identity [email protected]

Bitte beachten Sie: Stellen Sie sicher, dass Sie das Dienstkonto so konfigurieren, dass seine Anmeldedaten nicht ablaufen!

3.2 Nachahmung:

Die Impersonation muss aufgrund der Quotenkonfigurationen von Exchange konfiguriert werden. Es gibt zwei Möglichkeiten, dies zu konfigurieren, lesen Sie bitte die beiden Optionen unten.

Weitere Informationen darüber, warum Impersonation verwendet wird, finden Sie in dem folgenden MSDN-Artikel.

3.2.1 Nur Zimmerbriefkästen - maximale Beschränkung

Damit die Integration des Raumkalenders funktioniert, müssen dem Dienstkonto, wie oben beschrieben, "Impersonationsrechte" erteilt werden. Das Mindestmaß an Zugriff ist, dass Sie Impersonation-Zugriff auf die Raumpostfächer haben, in die Sie integrieren möchten. Auf diese Weise wird die Integration korrekt funktionieren und es wird keine Drosselungsgrenzen von Exchange geben.

Erstellen Sie zunächst ein Managementscope für die Ressourcenpostfächer, indem Sie den folgenden Befehl ausführen:

New-ManagementScope -Name "GoBrightResourceMailboxes" -RecipientRestrictionFilter { RecipientTypeDetails -eq "RoomMailbox" -or RecipientTypeDetails -eq "EquipmentMailbox" }

Wenden Sie dann den folgenden Befehl an, der das erstellte managementscope dem Dienstkonto zuweist, und ändern Sie den Parameter User in die E-Mail-Adresse des von Ihnen erstellten Dienstkontos:

New-ManagementRoleAssignment –Name "ResourceImpersonation" –Role ApplicationImpersonation –User [email protected] –CustomRecipientWriteScope "GoBrightResourceMailboxes"

Führen Sie den folgenden Befehl aus, um zu prüfen, ob die Berechtigungen gegeben sind, und ändern Sie RoleAssignee in die E-Mail-Adresse des von Ihnen erstellten Dienstkontos. Das Ergebnis des Befehls sollte mindestens eine Zeile mit dem Dienstkonto enthalten.

Get-ManagementRoleAssignment -RoleAssignee [email protected] -Role ApplicationImpersonation -RoleAssigneeType user

3.3.2 Vollständige Integration - maximale Integration

Um eine vollständige Integration mit dem Kalender des Benutzers zu ermöglichen (für integrierte Benutzer in GoBright), ist es notwendig, dem Dienstkonto "Impersonations"-Rechte zu geben.

Auf diese Weise wird eine neue Buchung für einen integrierten Raum vorgenommen, indem ein Termin im Kalender des Benutzers erstellt und der Raum eingeladen wird (beim Erstellen eines Termins in GoBright). Auf diese Weise kann der Benutzer später die Buchung leicht ändern, da er der Organisator ist, und die Buchung des Raums wird automatisch geändert.

Führen Sie den folgenden Befehl aus und ändern Sie den Parameter User in die E-Mail-Adresse des von Ihnen erstellten Dienstkontos:

New-ManagementRoleAssignment –Name:GoBrightImpersonation –Role:ApplicationImpersonation –User:[email protected]

Führen Sie den folgenden Befehl aus, um zu prüfen, ob die Berechtigungen gegeben sind, und ändern Sie RoleAssignee in die E-Mail-Adresse des von Ihnen erstellten Dienstkontos. Das Ergebnis des Befehls sollte mindestens eine Zeile mit dem Dienstkonto enthalten.

Get-ManagementRoleAssignment -RoleAssignee [email protected] -Role ApplicationImpersonation -RoleAssigneeType user

3.3 Abschluss der Erstellung des Dienstkontos:

Das Dienstkonto ist nun erstellt:

  • Als Konto mit einer Mailbox
  • Mit einem nicht ablaufenden Passwort (bitte überprüfen Sie dies, dies ist eine manuelle Aktion, wahrscheinlich in ActiveDirectory)
  • Mit Nachahmungsrechten

Bitte notieren Sie sich die folgenden Angaben, da Sie sie später im Portal GoBright benötigen:

  • Die Anmeldedaten des Dienstkontos (E-Mail-Adresse und Passwort)

4. Erstellen Sie die Raumkalender in Exchange

Mit den folgenden Schritten können Sie Räume in Ihrer Exchange-Umgebung erstellen. Dadurch werden die Räume in Exchange veröffentlicht, und für jeden Raum wird ein Kalender angelegt.

Wenn Sie bereits über Raumkalender in Ihrer Exchange-Umgebung verfügen, fahren Sie mit dem nächsten Schritt fort, aber vergewissern Sie sich, dass Sie die E-Mail-Adressen der Räume haben, da Sie diese später noch benötigen werden.

Führen Sie die folgenden Befehle über die Exchange Management Shell aus.

Führen Sie den folgenden Befehl aus, ändern Sie den UserPrincipalName auf die gewünschte Raum-E-Mail-Adresse und geben Sie einen korrekten Namen, DisplayName und für diesen Raum ein:

New-Mailbox -Room -UserPrincipalName [email protected] -Name Room1 -DisplayName 'Room 1'

Bei Bedarf können Sie mit dem Parameter -Database eine bestimmte "Exchange-Datenbank" und mit dem Parameter -OrganizationalUnit die Organisationseinheit festlegen. Der obige Beispielbefehl geht von der Standard-Exchange-Datenbank und -Organisationseinheit aus.

Führen Sie diesen Befehl für jeden Raum aus, den Sie erstellen möchten.

5. Erlauben Sie dem Dienstkonto den Zugriff auf die Raum-Mailboxen

Das Dienstkonto benötigt FullAccess-Rechte für das Raumpostfach, damit es das Raumpostfach zur Verwaltung der Buchungen nutzen kann.

Führen Sie die folgenden Befehle über die Exchange Management Shell aus.

Führen Sie den folgenden Befehl aus, ändern Sie Identity in die E-Mail-Adresse des Raums und User in die E-Mail-Adresse des Dienstkontos:

Get-User -Identity [email protected] | Add-MailboxPermission -User [email protected] -AccessRights FullAccess

Führen Sie diesen Befehl für jeden Raum aus, den Sie erstellen möchten.

Bitte beachten Sie: In der Regel dauert es 15 bis 30 Minuten, bis dieser Vorgang abgeschlossen ist, es kann aber auch bis zu 48 Stunden dauern; Exchange gibt Ihnen keine Auskunft darüber, wann dieser Vorgang abgeschlossen ist. Wenn Sie fortfahren, während dies in Exchange nicht aktiv ist, werden einige Funktionen in GoBright nicht richtig funktionieren (z. B. Ändern/Speichern eines Raums, Verlängern/Beenden eines Meetings usw.)

6. Erstellen Sie eine "Raumliste" in Exchange

Um die Raumpostfächer einfach zu veröffentlichen, sollten Sie eine oder mehrere 'Verteilergruppen' vom Typ 'Raumliste' erstellen.
Möglicherweise möchten Sie mehrere "Raumlisten" erstellen, z. B. pro Gebäude, pro Stockwerk usw.

Es ist möglich, diesen Schritt zu überspringen, aber dann müssen Sie die Räume manuell in GoBright erstellen, anstatt sie zu synchronisieren.

Führen Sie die folgenden Befehle über die Exchange Management Shell aus.

Erstellen Sie zunächst die Raumliste, ändern Sie den Namen, wenn Sie der Raumliste einen anderen Namen geben möchten:

New-DistributionGroup -Name 'BrightBooking Rooms' –RoomList

Fügen Sie nun jedes Raumpostfach mit dem folgenden Befehl hinzu, ändern Sie die Identität in den Namen der Liste und das Mitglied in die E-Mail-Adresse des Raums:

Add-DistributionGroupMember -Identity 'BrightBooking Rooms' -Member [email protected]

Führen Sie diesen Befehl für jedes Raumpostfach aus, damit jedes Raumpostfach in die Liste aufgenommen wird.

7. Konfigurieren Sie den Standardzugang der Benutzer zu den Raumpostfächern

Nun sollte der Zugang der Benutzer zu den Raumpostfächern konfiguriert werden.

Führen Sie die folgenden Befehle über die Exchange Management Shell aus.

Mit dem folgenden Befehl setzen Sie den Standardzugriff für jedes Raumpostfach auf 'nur lesen, mit eingeschränkten Details', dies ist in der Regel am besten, damit Benutzer nicht direkt im Raumpostfach Änderungen vornehmen können. Ändern Sie den Wert von Identity auf die E-Mail-Adresse des Raums.

Set-MailboxFolderPermission -Identity [email protected]:Calendar -User Default -AccessRights LimitedDetails

Hinweis: Der Ordnername 'Calendar' hängt von den kulturellen Einstellungen des Raumpostfachs ab, so dass 'Calendar' auch ein übersetzter Wert wie 'Agenda' sein kann. Der Befehl wird mit einer Fehlermeldung fehlschlagen, wenn Sie den falschen Ordnernamen verwenden.

Führen Sie den folgenden Befehl aus, um den Ordnernamen zu ermitteln (z. B. wenn der obige Befehl fehlschlägt):

Get-MailboxFolderStatistics -Identity [email protected] | Where-Object {$_.FolderType -eq "Calendar"} | Select Name,FolderType,Identity

8. Konfigurieren Sie das Verhalten der Raum-Mailboxen

Das Standardverhalten eines Raumpostfachs ändert den Betreff des Termins und entfernt das Kennzeichen "Privat", falls es gesetzt ist. Mit dem folgenden Befehl wird das Raumpostfach so konfiguriert, dass es Besprechungsanfragen automatisch bearbeitet (annehmen/ablehnen) und die Daten der Besprechung beibehält.

Führen Sie den folgenden Befehl über die Exchange Management Shell aus.

Konfigurieren Sie das Verhalten des Raumpostfachs, ändern Sie den Identitätsparameter der E-Mail-Adresse in die E-Mail-Adresse des Raums:

Set-CalendarProcessing -Identity [email protected] -AutomateProcessing AutoAccept -DeleteSubject $False -DeleteComments $False -AddOrganizerToSubject $False -RemovePrivateProperty $False -AllowConflicts $False

Führen Sie diesen Befehl für jede Raum-Mailbox aus.

Bei Bedarf können Sie diese bewährte Vorgehensweise ändern, um ein anderes Verhalten zu erreichen. Die folgenden Parameter sind die wichtigsten:

  • AutomateProcessing: AutoAccept bewirkt, dass das Raumpostfach Besprechungen automatisch verarbeitet (annehmen/ablehnen). Es ist auch möglich, dies manuell über den Wert "None" zu tun(weitere Informationen), aber das bedeutet auch, dass Sie Stornierungen manuell bearbeiten müssen.
  • Betreff löschen: Indem wir den ursprünglichen Betreff beibehalten, können wir den Betreff im Portal, in der App und auf den Displays anzeigen. Dies ist über den Wert $False möglich. Wenn Sie den Wert $True verwenden, wird das Thema von der Raum-Mailbox gelöscht.
  • Kommentare löschen: Wenn wir die Kommentare behalten, können wir das Thema im Portal und in der App anzeigen. Dies ist über den Wert $False möglich. Wenn Sie den Wert $True verwenden, werden die Kommentare von der Raum-Mailbox gelöscht.
  • AddOrganizerToSubject: Die Raum-Mailbox kann den Namen des Organisators zum Betreff hinzufügen, aber das kann verwirrend sein. Durch die Verwendung des Wertes $False wird dies deaktiviert.
  • RemovePrivateProperty: Die Raum-Mailbox entfernt die private Eigenschaft aus der eingehenden Besprechung. Durch die Verwendung des Wertes $False behält das Meeting seine private Eigenschaft.
  • Konflikte zulassen: Mit dem Wert $False lässt das Raumpostfach keine neuen Besprechungen zu, wenn im gleichen Zeitrahmen eine andere Besprechung geplant ist.

9. Suchen Sie die FWS-Adresse

Der letzte Schritt ist die Ermittlung der EWS-Internetadresse, zu der GoBright eine Verbindung herstellen wird:

  • Suchen Sie die Webmail-Internetadresse Ihrer Exchange-Umgebung, zum Beispiel: https://mail.company.com/owa
  • Die EWS-URL unterscheidet sich leicht von der Webmail-Internetadresse: https://mail.company.com/EWS/Exchange.asmx
  • Ändern Sie Ihre URL auf die gleiche Weise und rufen Sie diese URL über Ihren Webbrowser auf
  • Wenn dies die richtige URL ist, müssen Sie möglicherweise Ihre Anmeldedaten eingeben. Verwenden Sie Ihre neu erstellten Anmeldedaten für das Dienstkonto.
  • Wenn dies korrekt ist, wird eine technische Webseite angezeigt, die wie das folgende Bild aussieht:
    Beispiel einer technischen Webseite
  • Notieren Sie sich die URL, Sie benötigen sie im Portal GoBright .

10. Nächste...

Nun sind Sie bereit, die "Integration" im Portal GoBright zu konfigurieren und die Räume in GoBrightanzulegen.

Dieser Artikel stammt aus dem Help Center von GoBright.

Originalartikel ansehen

FAQ

Fragen Sie uns alles! Hier finden Sie die Antworten auf die am häufigsten gestellten Fragen.

Durchsuchen Sie die FAQs

Hilfe-Center

Eine Fundgrube für alle IT- und Facility-Manager. Tauchen Sie ein in die technischen Details unserer Produkte und Lösungen.

Besuchen Sie das Help Center

Newsletter

Möchten Sie über alle Entwicklungen im Smart Office und unsere neuen Funktionen informiert werden? Abonnieren Sie jetzt unseren Newsletter.

Jetzt abonnieren