Dieser Artikel stellt ein Powershell Script bereit, mit dem Du die EntraID App Registrierungen erstellen kannst, die Swyx für die verbundbasierte Authentifizierung, die bidirektionale Swyx / Microsoft Teams Präsenzstatussynchronisation und das Swyx Direct for MS Teams Feature benötigt.

Voraussetzungen

Powershell >=7
Microsoft.Graph PowerShell Modul (Benutze Install-Module Microsoft.Graph zum Installieren)
EntraID Konto, welches das Recht hat, App Registrierungen in deinem Entra ID zu verwalten

Entra ID App Registrierungen erzeugen

Das Skript verfügt über zwei Modi, einen zum Erstellen der App-Registrierung für Swyx EntraID-Verbunddienste (SSO, MS Teams Presence Sync, Kontakt-Sync, Kalendar-Sync) und einen zum Erstellen der App-Registrierung für die Swyx MS Teams Direct Routing Provisioning.

1. Führe das Script aus:

.\RegisterSwyxEntraIDApp.ps1

und folge den Anweisungen. Das Script nutzt Standardeinstellungen, d.h. konfiguriert die Berechtigungen, die für die Verwendung von Swyx Entra ID Federated Services oder Swyx MS Teams Direct Routing erforderlich sind.

HINWEIS: Der "Friendly App Name" der App-Registrierung für die Verbundauthentifizierung ist eine für den Benutzer beim Login sichtbare Zeichenfolge.

HINWEIS: Das Skript verwendet standardmäßig die App-Berechtigungen, die für alle Funktionen der Swyx Entra ID-Verbunddienste erforderlich sind. Wenn Sie Berechtigungen für Funktionen entfernen, die Sie nicht verwenden, denken Sie daran, dass Sie sie später manuell hinzufügen müssen, z. B. über das Azure-Portal.

Für Swyx Direct for MS Teams ermöglicht das Skript auch das Entfernen der Entra-ID-Rollen, die nur während des Onboardings erforderlich sind.

2. IDs kopieren

Kopiere die IDs und ggfs. URL, die das Script am Ende ausgibt. Du benötigst diese Werte im nächsten Schritt.

3. Swyx konfigurieren

Benutze Swyx Control Center, um die EntraID Verbunddienste oder Swyx Direct for MS Teams zu konfigurieren. Details findest Du im Swyx Handbuch auf https://help.enreach.com

4. EntraID Berechtigungen entfernen

Für MS Teams Direct Routing konfiguriert das Script Berechtigungen, die die App-Registrierung nur während der initialen Konfiguration benötigt Wenn Du Swyx Direct For MS Teams im Swyx Control Center erfolgreich konfiguriert hast, solltest Du die nicht mehr notwendigen Berechtigungen der App-Registrierung entfernen Führe dazu das Skript wieder aus und nutze diese Parameter (verwende Sie Ihre Anwendungs-ID, die das Script für die Swyx Direct For MS Teams App Registrierung erzeugt hat):

.\RegisterSwyxEntraIDApp.ps1 -RemoveOnboardingRoles -ApplicationID "<Swyx Direcr for MS Teams App ID>"

Skript Online-Hilfe

Das Skript unterstützt die get-help-Funktionalität von Powershell. Nutze für die komplette Hilfe:

Get-Help -Full .\RegisterSwyxEntraIDApp.ps1

oder

.\RegisterSwyxEntraIDApp.ps1 -?

für die kompakte Version.

RegisterSwyxEntraIDApp.zip9 kB

Entra ID App Registration für verbundbasierte Authentifizierung, Swyx / Microsoft Teams Präsenzstatussynchronisation und Swyx Direct for MS Teams mit PowerShell für Swyx 15ff