4.22 Swyx Anwendungen in Azure mit PS Skript registrieren
Mit dem PowerShell Skript können Sie eine Microsoft Entra ID Anwendungsregistrierung für Swyx Integrationen erstellen oder aktualisieren. Das Skript registriert eine entsprechende Swyx Anwendung in Microsoft Entra ID und erzeugt einen geheimen Clientschlüssel für die weitere Konfiguration im Swyx Control Center.
Das Skript registriert zwei Swyx Anwendungen für:
*Verbunddienste in Entra ID (Single Sign-On) sowie die Synchronisierung von Teams-Präsenzstatus, Kalendern und Kontakten, siehe 4.21 Verbunddienste über Identitätsanbieter.
oder
*Swyx Direct für Microsoft Teams, siehe 4.23 Swyx Direct für MS Teams Einrichten. Die Anwendung für Verbunddienste in Entra ID muss bereits registriert sein.
Die Datei EntraID_PowerShell_Configuration.zip können Sie von dieser Webseite herunterladen:
So registrieren Sie die Swyx Anwendung für Verbunddienste
Verwenden Sie diesen Modus für Verbunddienste wie Single Sign-On sowie die Synchronisierung von Teams-Präsenzstatus, Kalendern und Kontakten.
1 Entpacken Sie die Zip-Datei „EntraID_PowerShell_Configuration.zip“ in einem Ordner auf Ihrer Festplatte.
*In dem Ordner sind die Dateien „RegisterSwyxEntraIDApp.ps1“ und „README.md“.
2 Lesen Sie die README-Datei.
3 Öffnen Sie eine PowerShell-Konsole als Administrator (z.B. Im Kontextmenü „Run as Administrator“).
4 Wenn das Ausführen lokaler Skripte blockiert ist, stellen Sie die Ausführungsrichtlinie mit dem Befehl ein:
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
5 Wechseln Sie zu dem Ordner mit der .ps1-Datei.
z.B.: cd 'C:\Users\<user.name>\Downloads\EntraID_PowerShell_Configuration\'
6 Führen Sie ggf. den folgenden Befehl aus, um die ausführliche Hilfe zum Skript anzuzeigen:
get-help -full RegisterSwyxEntraIDApp.ps1
7 Führen Sie das Skript mit dem Befehl aus:
.\RegisterSwyxEntraIDApp.ps1
8 Drücken Sie die Taste [1], um die Swyx Anwendung für Verbunddienste zu wählen:
1) Swyx Federated Services
9 Bestätigen Sie mit [Enter].
10 Geben Sie den gewünschten Namen der Anwendung ein oder drücken Sie die Taste [Enter], um den Standardnamen zu verwenden.
11 Bestätigen Sie die Registrierung mit [ J ] bzw. [ Y ].
*Die Anwendung wird registriert. Anschließend erscheinen folgende Daten:
SUCCESS
------------------------------------
Application ID:
Tenant/Domain ID:
Client Secret:
Secret expires:
OpenID Connect Metadata Document:
-------------------------------------
12 Speichern Sie die Registrierungsdaten für den nächsten Schritt an einem sicheren Ort. Bewahren Sie insbesondere das Client Secret an einem geschützten Ort auf.
13 Sie können eine Identitätsanbieter-Konfiguration neu erstellen, siehe 4.21.3 Identitätsanbieter-Konfiguration erstellen,
oder
die Anmeldedaten einer existierenden Konfiguration aktualisieren, siehe 4.21.5 Anmeldedaten für Entra ID ändern.
So registrieren Sie die Swyx Anwendung für Swyx Direct
Verwenden Sie diesen Modus für die Registrierung der Anwendung für Swyx Direct für Microsoft Teams.
Die Verbunddienste in Entra ID sind für Ihre Swyx Installation eingerichtet.
 
Bei dieser Registrierungsart weist das Skript für das Onboarding vorübergehend zusätzliche Microsoft Entra Verzeichnisrollen zu.
Entfernen Sie nach erfolgreicher Inbetriebnahme nur diese temporären Onboarding-Rollen mit dem unten angegebenen Befehl, siehe Schritt (14).
 
 
Im Schritt (11), nach der Anmeldung prüft das Skript, ob für TEAMS1 (Microsoft Teams) und MCOEV (Teams Phone) jeweils freie Lizenzen mit aktiven Serviceplänen verfügbar sind. Fehlt eine erforderliche Lizenz oder ist ein Serviceplan inaktiv, beendet das Skript den Vorgang, bevor Änderungen vorgenommen werden. Um die Prüfung bewusst zu überspringen, starten Sie das Skript mit dem Parameter -SkipLicenseCheck. Bestätigen Sie anschließend die angezeigten Änderungen.
Siehe Microsoft Serviceplan-Lizenzen auf Azure.
 
1 Entpacken Sie die Zip-Datei „EntraID_PowerShell_Configuration.zip“ in einem Ordner auf Ihrer Festplatte.
*In dem Ordner sind die Dateien „RegisterSwyxEntraIDApp.ps1“ und README.md.
2 Lesen Sie die README-Datei.
3 Öffnen Sie eine PowerShell-Konsole als Administrator (z.B. Im Kontextmenü „Run as Administrator“).
4 Falls das Ausführen lokaler Skripte blockiert ist, stellen Sie die Ausführungsrichtlinie ggf. mit dem Befehl ein:
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
5 Wechseln Sie zu dem Ordner mit der .ps1-Datei.
z.B.: cd 'C:\Users\<user.name>\Downloads\RegisterSwyxEntraIDApp'
6 Führen Sie ggf. den folgenden Befehl aus, um die ausführliche Hilfe zum Skript anzuzeigen:
get-help -full RegisterSwyxEntraIDApp.ps1
7 Führen Sie das Skript mit dem Befehl aus:
.\RegisterSwyxEntraIDApp.ps1
8 Drücken Sie die Taste [2], um die Swyx Anwendung für Swyx Direct zu wählen:
2) Swyx Teams Direct Routing
9 Bestätigen Sie mit [Enter].
10 Geben Sie den gewünschten Namen der Anwendung ein oder drücken Sie [Enter], um den Standardnamen zu verwenden.
11 Melden Sie sich im angezeigten Anmeldedialog mit einem Microsoft Entra Administratorkonto an, das die erforderlichen Berechtigungen und Administratorzustimmungen erteilen kann.
*Die Anwendung wird registriert. Anschließend erscheinen folgende Daten:
SUCCESS
------------------------------------
Application ID:
Tenant/Domain ID:
Client secret:
Secret expires:
OpenID Connect Metadata Document:
-------------------------------------
12 Speichern Sie die Registrierungsdaten für den nächsten Schritt an einem sicheren Ort. Bewahren Sie insbesondere das Client Secret an einem geschützten Ort auf.
13 Sie können Ihr Swyx-System mit Swyx Direct für Microsoft Teams verbinden, 4.23.1 Swyx Direct für MS Teams verbinden,
14 Entfernen Sie nach erfolgreicher Inbetriebnahme von Swyx Direct für Microsoft Teams die vom Skript nur für das Onboarding zugewiesenen temporären Verzeichnisrollen mit dem folgenden Befehl:
.\RegisterSwyxEntraIDApp.ps1 -RemoveOnboardingRoles -ApplicationId '<Application ID>'