
Windows-Client verteilen
Den echo Windows-Client auf die Computer Ihrer Organisation ausrollen, mit Fokus auf Microsoft Intune
Übersicht
Der echo Windows-Client wird für die Live-Anruferidentifikation benötigt. Er wird als signiertes MSIX-Paket (.appxbundle für x86 und x64) zusammen mit einer App-Installer-Datei (.appinstaller) ausgeliefert. Beide werden von der Snapbean Software AG unter einer festen Adresse bereitgestellt:
https://sateamsmateclientprod.blob.core.windows.net/windows-client/installer/Snapbean.TeamsMate.Client.Windows.Package.appinstaller
Die App-Installer-Datei verweist immer auf die neueste Version des Pakets. Wie Sie den Client installieren, entscheidet darüber, ob er sich selbst aktuell hält:
| Option A: App Installer (empfohlen) | Option B: App-Paket (.appxbundle) | |
|---|---|---|
| Automatische Updates | Ja – der Client prüft bei jedem Start auf eine neue Version und aktualisiert sich selbst | Nein – jede neue Version muss erneut verteilt werden |
| Microsoft Intune | Über ein kleines PowerShell-Skript (die .appinstaller-Datei kann nicht direkt in Intune hochgeladen werden) | Direkt als Branchenspezifische App (Line-of-business app) |
| Aufwand für die IT | Einmalig | Bei jedem Release |
| Typischer Einsatz | Die meisten Organisationen | Organisationen, die jede Softwareversion vor dem Rollout freigeben müssen |
Voraussetzungen
- Windows 10 Version 1809 oder neuer bzw. Windows 11.
- Die Installation signierter Apps (Sideloading) darf nicht blockiert sein. Ab Windows 10 Version 2004 ist sie standardmässig erlaubt; bei älteren Versionen oder wenn eine Richtlinie sie einschränkt, erlauben Sie die Installation vertrauenswürdiger Apps.
- Die Computer müssen
sateamsmateclientprod.blob.core.windows.netüber HTTPS erreichen können (für die Installation und bei Option A für Updates). - Es muss kein zusätzliches Zertifikat installiert werden: Das Paket ist mit einem öffentlich vertrauenswürdigen Code-Signing-Zertifikat der Snapbean Software AG signiert.
Der Client wird pro Benutzer installiert. Nach der Installation meldet sich jeder Benutzer einmalig mit seinem Microsoft-Konto an. Danach läuft der Client im Hintergrund und startet automatisch mit Windows.
Option A: App Installer mit automatischen Updates (empfohlen)
Wird der Client über die App-Installer-Datei installiert, merkt sich Windows, woher das Paket stammt. Bei jedem Start prüft der Client diese Adresse auf eine neuere Version und installiert sie automatisch. Sie müssen nie selbst ein Update verteilen.
Manuell installieren (einzelne Computer)
Öffnen Sie den obigen App-Installer-Link auf dem Computer in einem Browser oder laden Sie die .appinstaller-Datei herunter und doppelklicken Sie darauf. Windows zeigt den App-Installer-Dialog an; klicken Sie auf Installieren.
Mit Microsoft Intune verteilen
Microsoft Intune kann eine .appinstaller-Datei nicht als App verteilen. Stattdessen verteilen Sie ein kurzes PowerShell-Skript, das im Kontext des angemeldeten Benutzers läuft und den Client mit dem Befehl Add-AppxPackage aus der App-Installer-Datei installiert.
PowerShell-Skript erstellen
Speichern Sie das folgende Skript als Install-EchoClient.ps1:
$appInstallerUri = 'https://sateamsmateclientprod.blob.core.windows.net/windows-client/installer/Snapbean.TeamsMate.Client.Windows.Package.appinstaller'
$packageName = 'd10d600d-78e9-4853-aecc-84552804a53a'
if (Get-AppxPackage -Name $packageName) {
Write-Output 'echo Windows client is already installed.'
exit 0
}
try {
Add-AppxPackage -AppInstallerFile $appInstallerUri -ErrorAction Stop
Write-Output 'echo Windows client installed.'
exit 0
} catch {
Write-Error "Installation of the echo Windows client failed: $_"
exit 1
}
Das Skript installiert den Client nur, wenn er noch nicht vorhanden ist. Alle späteren Updates kommen automatisch über den App Installer.
Skript in Intune hinzufügen
Öffnen Sie im Microsoft Intune Admin Center Geräte → Skripts und Wartungen → Plattformskripts und klicken Sie auf Hinzufügen → Windows 10 und höher. Vergeben Sie einen Namen (z. B. echo Windows-Client) und laden Sie Install-EchoClient.ps1 hoch.
Verwenden Sie diese Einstellungen:
| Einstellung | Wert |
|---|---|
| Dieses Skript mit den Anmeldeinformationen des angemeldeten Benutzers ausführen | Ja – der Client wird pro Benutzer installiert, das Skript muss deshalb als Benutzer laufen, nicht als SYSTEM |
| Überprüfung der Skriptsignatur erzwingen | Nein (ausser Sie signieren das Skript mit einem eigenen Zertifikat) |
| Skript in 64-Bit-PowerShell-Host ausführen | Ja |
Skript zuweisen
Weisen Sie das Skript den Benutzer- oder Gerätegruppen zu, die echo nutzen sollen, und speichern Sie. Das Skript wird beim nächsten Intune-Check-in des Geräts ausgeführt, während ein Benutzer angemeldet ist.
.intunewin) mit Installationsverhalten Benutzer verpacken und ein eigenes Erkennungsskript auf Basis von Get-AppxPackage -Name d10d600d-78e9-4853-aecc-84552804a53a verwenden. Automatische Updates funktionieren gleich.Option B: App-Paket ohne automatische Updates
Alternativ können Sie die .appxbundle-Datei direkt als verwaltete App in Intune verteilen. Intune installiert dann genau diese Version. Der Client aktualisiert sich in diesem Fall nicht selbst: Für jede neue Version müssen Sie das neue Paket in Intune hochladen und erneut verteilen.
Aktuelles Paket herunterladen
Öffnen Sie den obigen App-Installer-Link in einem Browser. Die .appinstaller-Datei ist eine kleine XML-Datei; das Attribut Uri des Elements MainBundle enthält die Download-Adresse der aktuellen .appxbundle-Datei. Laden Sie diese Datei herunter.
Branchenspezifische App hinzufügen
Öffnen Sie im Microsoft Intune Admin Center Apps → Windows → Hinzufügen, wählen Sie den App-Typ Branchenspezifische App und laden Sie die .appxbundle-Datei hoch. Intune liest Name, Herausgeber und Version aus dem Paket. Als App-Paketkontext empfehlen wir Benutzer.
App zuweisen
Weisen Sie die App den gewünschten Benutzer- oder Gerätegruppen als Erforderlich zu (oder als Verfügbar, um sie im Unternehmensportal anzubieten).
Updates verteilen
Wird eine neue Version des echo Windows-Clients veröffentlicht, laden Sie das neue Paket herunter (Schritt 1) und ersetzen Sie das Paket der bestehenden App in Intune unter Eigenschaften → App-Informationen → Bearbeiten durch die neue .appxbundle-Datei.
Eine Option pro Computer wählen
Kombinieren Sie die beiden Optionen nicht auf denselben Computern. Ein Client, der über Intune aus dem .appxbundle installiert wurde, ist nicht mit dem App Installer verknüpft und aktualisiert sich daher nicht selbst, und Intune kann eine über den App Installer aktualisierte Version erneut installieren oder überschreiben. Wechseln Sie von Option B zu Option A, entfernen Sie zuerst die Zuweisung der branchenspezifischen App (oder weisen Sie sie als Deinstallieren zu) und verteilen Sie dann das Skript aus Option A.
Fehlerbehebung
- Installierte Version prüfen in PowerShell als Benutzer:
Get-AppxPackage -Name d10d600d-78e9-4853-aecc-84552804a53a | Select-Object Name, Version - Skriptergebnis in Intune: Den Status eines Plattformskripts finden Sie unter Geräte → Skripts und Wartungen → Plattformskripts → (Skript) → Gerätestatus / Benutzerstatus. Protokolle liegen auf dem Gerät unter
C:\ProgramData\Microsoft\IntuneManagementExtension\Logs\IntuneManagementExtension.log. - Installationsfehler: Windows protokolliert Details in der Ereignisanzeige unter Anwendungs- und Dienstprotokolle → Microsoft → Windows → AppxDeployment-Server → Microsoft-Windows-AppXDeploymentServer/Operational.
- Durch Sicherheitssoftware blockiert: siehe Sicherheit und Endpoint-Schutz.