Verwaltete Einstellungen

Schnellstart mit Gruppenrichtlinie#

1. Lade TypeWhisper-win-PolicyTemplates.zip aus dem Release, das du verteilst, und kopiere die ADMX- und ADML-Dateien in den zentralen Speicher.
2. Öffne im Gruppenrichtlinienverwaltungs-Editor Computerkonfiguration > Administrative Vorlagen > TypeWhisper und setze die Einstellungen, die du brauchst, etwa „Cloud-Transkription erlauben“ oder „Update-Modus der Anwendung“.
3. Führe auf einem Testgerät gpupdate /target:computer aus und prüfe in TypeWhisper Einstellungen > Erweitert > Verwaltete Einstellungen.

Details stehen unter Gruppenrichtlinie. Für Intune oder andere Werkzeuge siehe Intune und Registry und Skripte.

So funktionieren verwaltete Einstellungen#

TypeWhisper liest Computerrichtlinien aus zwei Registry-Schlüsseln. Gruppenrichtlinie, Intune und andere Verwaltungswerkzeuge schreiben dieselben Werte.

Setzen mehrere Quellen einen Wert, gilt diese Reihenfolge:

1. Erzwungene Richtlinie
2. Eigene Wahl des Benutzers
3. Empfohlene Richtlinie
4. Standard der App

Die App liest die 64-Bit-Ansicht der Registry und schreibt die Schlüssel nie. Sie liest die Richtlinie, bevor Plugins und Hintergrundaufgaben starten, daher gelten Werte, die beim ersten Start vorhanden sind, sofort. Spätere Änderungen erkennt die laufende App über eine Registry-Benachrichtigung, ersatzweise durch eine Prüfung alle 30 Sekunden, und übernimmt sie ohne Neustart. Standardbenutzer können HKLM nicht schreiben und erzwungene Werte daher nicht ändern.

Werttypen und Listen#

• Schalter sind REG_DWORD mit 0 oder 1, Auswahlwerte sind REG_DWORD-Zahlen, Text ist REG_SZ.
• Eine Liste ist ein Unterschlüssel mit nummerierten REG_SZ-Werten (1, 2, …) und daneben ein REG_DWORD namens <Name>Configured. Fehlt diese Markierung oder ist sie 0, schränkt die Liste nichts ein. Ist sie 1, sind nur die aufgeführten Einträge erlaubt; eine leere Liste erlaubt nichts.
• Ein Eintrag, der auf nichts passt, etwa none, erlaubt ebenfalls nichts. Die Gruppenrichtlinie braucht diese Form, weil ihr Editor eine aktivierte Liste ohne Einträge nicht speichert.

Ungültige und unbekannte Werte#

• Ein ungültiger erzwungener Wert sperrt seine Einstellung, bis er korrigiert ist. Er lockert nie eine Einschränkung.
• Lässt sich der Richtlinienschlüssel nicht lesen, behält die App die zuletzt bekannten Werte und sperrt verwaltete Vorgänge.
• Einschränkungen unter Recommended und unbekannte Werte meldet die App als Richtlinienproblem und ignoriert sie.
• Wird ein Wert entfernt, gilt wieder die Einstellung des Benutzers. Wird der ganze Schlüssel entfernt, gelten wieder alle Einstellungen der Benutzer.

Referenz der Werte#

Alle Werte liegen unter HKLM\SOFTWARE\Policies\TypeWhisper. Werte, die auch empfohlen werden können, stehen zusätzlich unter Recommended. Paare und Listen sind unten näher beschrieben.

Lizenz#

Modelle#

Updates und Start#

Daten und Plugins#

Anbieter-Modell-Paare#

Ein Paar nennt einen Anbieter über seine Auswahl-ID und ein Modell über die ID, die der Anbieter auflistet. Beide Werte gehören unter denselben Schlüssel. Ein Paar mit nur einem Wert ist ungültig; die betroffene Funktion wartet, bis es vollständig ist.

• Lokale Parakeet-Engine: com.typewhisper.sherpa-onnx. Ihre Modell-IDs zeigt die Seite „Diktat“ an, und GET /v1/models liefert sie im Feld id, zum Beispiel parakeet-tdt-0.6b. Die API selbst nennt die Engine sherpa-onnx mit provider_id local; in Richtlinien gehört die Paket-ID.
• Cloud-Plugins: ihre Paket-ID, etwa com.typewhisper.groq oder com.typewhisper.openai, und die Modell-IDs, die ihre Einstellungsseite auflistet, zum Beispiel whisper-large-v3.
• Endpunkt-Profile des Plugins OpenAI Compatible: openai-compatible-<id>.
• Textmodelle: dieselben Paket-IDs, mit den Modell-IDs, die der Workflow-Editor für diesen Anbieter anbietet.

.\Set-TypeWhisperPolicy.ps1 -String @{ TranscriptionProviderId = 'com.typewhisper.sherpa-onnx'; TranscriptionModelId = 'parakeet-tdt-0.6b' }

Erzwungene Paare#

Ein erzwungenes Transkriptionspaar hat Vorrang vor der Auswahl des Benutzers, vor Diktat-Workflows mit eigenem Modell, vor wartenden und wiederhergestellten Aufträgen und vor Anfragen an die HTTP-API. Eine Anfrage für eine andere Engine oder ein anderes Modell erhält 403 forbidden. Die Auswahlfelder in Diktat und Einrichtung zeigen das Paar und sind gesperrt; die Schaltfläche „Anbieter-Einstellungen“ bleibt für API-Schlüssel und Downloads erreichbar. Die eigene Auswahl des Benutzers bleibt gespeichert und gilt wieder, sobald das Paar entfernt wird. Hat ein Plugin eine eigene Modellauswahl, wird sie auf das erzwungene Modell gestellt und nach dem Entfernen der Richtlinie zurückgesetzt.

Ein erzwungenes Textmodell-Paar ersetzt Anbieter und Modell jedes Workflows, des Standard-Workflow-LLM und der Übersetzung über die API. Der Workflow-Editor behält gespeicherte Auswahlen, sperrt aber die Auswahlfelder und nennt das erzwungene Paar; der Dialog „Standard-LLM“ ist schreibgeschützt. Text an einen anderen Anbieter oder ein anderes Modell wird abgelehnt.

Fehlende Anbieter und Modelle#

Eine unbekannte oder nicht verfügbare ID führt nie zu einem stillen Wechsel:

• Ein vorgegebener Anbieter, der nicht installiert, nicht aktiviert oder durch eine Erlaubnisliste oder einen Cloud-Schalter gesperrt ist, bleibt sichtbar ausgewählt. Diktat oder Verarbeitung werden mit Begründung blockiert.
• Ein vorgegebenes Modell, das der Anbieter nicht anbietet oder das nicht heruntergeladen ist, blockiert ebenso. Ist AllowModelDownloads auf 0, muss die Softwareverteilung die Modelldateien bereitstellen; sonst kann der Benutzer das Modell auf der Anbieterseite herunterladen.
• Einstellungen > Erweitert > Verwaltete Einstellungen listet diese Konflikte unter „Probleme in der Richtlinie“, direkt neben dem Paar.

Empfohlene Paare#

Ein empfohlenes Paar ist die erste Auswahl eines Profils, das noch keinen Transkriptionsanbieter gewählt oder kein Standard-Workflow-LLM gespeichert hat. Benutzer können es ändern; eine bestehende Wahl wird nie ersetzt. Ein empfohlenes Modell, das noch nicht heruntergeladen ist, lädt der Benutzer herunter oder die Softwareverteilung stellt es bereit. Bis dahin fragt die Einrichtung wie gewohnt nach einem bereiten Modell.

Cloud-Verarbeitung und Verarbeitungsort#

Jedes Plugin gibt im Feld locality an, wo es Inhalte verarbeitet; der Plugin-Katalog veröffentlicht denselben Wert:

• local: Nichts verlässt das Gerät.
• cloud: der feste Dienst des Anbieters.
• configurable: ein Endpunkt, Skript oder Befehl, den der Benutzer festlegt und den die App nicht prüfen kann.

Steht AllowCloudTranscription oder AllowCloudTextProcessing auf 0, laufen für diese Inhalte nur noch Plugins mit local. Plugins mit cloud oder configurable und Pakete ohne erkannten Wert werden abgelehnt. Ein Plugin ohne das Feld fällt auf sein älteres Feld isLocal zurück. Ein nicht lokales Paket, dessen Fähigkeiten alle abgeschaltet sind, wird ganz abgelehnt: Es wird weder installiert noch geladen oder aktiviert, und Marketplace und Plugin-Seite nennen den Grund. Auswahlfelder zeigen abgelehnte Einträge ausgegraut mit Begründung und wechseln eine Auswahl nie von selbst.

Bekannte Grenzen#

• AllowModelDownloads erfasst die Downloads, die die App startet. Lädt ein Plugin beim Laden eines Modells Laufzeitdateien nach, etwa GPU-Laufzeiten im Transkriptionsprozess oder die Vokabeldateien des lokalen Parakeet-Plugins, hält der Schalter das nicht auf. Stelle diese Dateien mit der Softwareverteilung bereit; die Hosts stehen auf der Seite Bereitstellung.
• Konfigurationsaktionen wie das Prüfen eines API-Schlüssels laufen unter AllowCloudTextProcessing weiter; sie übertragen Zugangsdaten, keine Transkripte.
• Ist ein abgelehnter Anbieter noch ausgewählt, wird er bei der Nutzung mit derselben Meldung abgelehnt.
• Audio, das ein Streaming-Anbieter vor einer strengeren Richtlinie bereits empfangen hat, lässt sich nicht zurückholen. Die Richtlinie wird beim nächsten Aufruf des Anbieters erneut geprüft.

Verwalteter Lizenzschlüssel#

ManagedLicenseKey aktiviert eine kommerzielle Lizenz in der Sitzung jedes Windows-Benutzers, der TypeWhisper startet. Du musst Polar nicht selbst aufrufen und den Schlüssel nicht an Benutzer verteilen. Leerzeichen am Anfang und Ende werden ignoriert, ein leerer Wert gilt als nicht gesetzt, und Supporter-Schlüssel werden nicht akzeptiert. Die App schreibt, ändert oder entfernt den Wert nie.

New-Item -Path 'HKLM:\SOFTWARE\Policies\TypeWhisper' -Force | Out-Null
Set-ItemProperty -Path 'HKLM:\SOFTWARE\Policies\TypeWhisper' -Name 'ManagedLicenseKey' -Value 'YOUR_LICENSE_KEY' -Type String

Verteile den Wert mit der Gruppenrichtlinie „Verwalteter Lizenzschlüssel“, einem Registry-Element in den Gruppenrichtlinieneinstellungen (Group Policy Preferences), einem Intune-PowerShell-Skript im Systemkontext oder jedem anderen Werkzeug, das HKLM schreibt. Halte echte Schlüssel aus Shell-Verläufen und Skript-Logs heraus.

Aktivierung und Plätze#

• Die App liest den Wert beim Start, wenn sich die Richtlinie im laufenden Betrieb ändert, und über „Aktivierung erneut versuchen“ unter Einstellungen > Premium > Lizenz.
• Sie speichert Schlüssel und Aktivierung in der Lizenzdatei des Benutzers, verschlüsselt mit Windows Data Protection (DPAPI), und aktiviert nicht bei jedem Start neu.
• Jedes Windows-Benutzerkonto auf einem Gerät hat eine eigene Aktivierung; ein Gerät mit mehreren Benutzern belegt also einen Platz pro Benutzer. Die direkte Installation und die Microsoft-Store-Version haben getrennte Profile: Wer beide nutzt, belegt einen Platz pro Version. Polar benennt jede Aktivierung nach Computer und Windows-Benutzer, zum Beispiel TYPEWHISPER (tw-user2).
• Die erste Aktivierung braucht eine Internetverbindung. Schlägt sie fehl, lässt sie sich auf der Lizenzseite oder beim nächsten Start wiederholen; einen automatischen Wiederholungsversuch im Hintergrund gibt es nicht. Bestehende Lizenzen behalten ihre normale Offline-Prüfung.
• Solange der Schlüssel verwaltet wird, blendet die Lizenzseite Schlüsseleingabe, Gerätedeaktivierung und Kauflinks aus, unterdrückt Premium-Kaufhinweise und zeigt den Lizenzstatus ohne den Schlüssel. Supporter-Schlüssel lassen sich dann nicht eingeben.

Schlüssel ändern oder entfernen#

• Ein neuer Schlüssel wird aktiviert und gespeichert, bevor die bisherige Aktivierung deaktiviert wird. Scheitert der neue Schlüssel, bleibt die bisherige Lizenz erhalten. Scheitert die Deaktivierung der alten Aktivierung, bleibt sie in Polar gelistet und lässt sich dort entfernen.
• Wird der Wert entfernt, kehren beim nächsten Start oder Aktivierungsversuch die manuellen Lizenzfunktionen zurück. Die bestehende Aktivierung bleibt bestehen: Deaktiviere das Gerät manuell oder widerrufe die Lizenz in Polar. Zentrale Änderungen bemerkt die App bei der nächsten Prüfung, beim Start, bei einem geänderten Schlüssel oder über „Aktivierung erneut versuchen“, sobald die letzte erfolgreiche Prüfung einer aktiven Lizenz mehr als sieben Tage zurückliegt.
• Einen Schlüssel, den Polar ablehnt, versucht die App nicht automatisch erneut. Eine in Polar gelöschte Aktivierung legt sie bei der nächsten Prüfung neu an, solange der konfigurierte Schlüssel gültig bleibt.

Gruppenrichtlinie#

Jedes Release enthält die Vorlagen als TypeWhisper-win-PolicyTemplates.zip, aufgebaut wie PolicyDefinitions: TypeWhisper.admx, die Sprachdateien für en-US und de-DE sowie Set-TypeWhisperPolicy.ps1. Nimm die Vorlagen aus dem Release, das du verteilst. Sie enthalten nur Computerrichtlinien und schreiben genau die Werte aus der Referenz oben.

• TypeWhisper-win-PolicyTemplates.zip
• Vorlagen und Skript im Repository

1. Kopiere TypeWhisper.admx in den zentralen Speicher \\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions und die ADML-Dateien in dessen Unterordner en-US und de-DE. Ohne zentralen Speicher nimmst du %SystemRoot%\PolicyDefinitions auf dem Computer, auf dem du die Richtlinie bearbeitest.
2. Öffne die Richtlinie im Gruppenrichtlinienverwaltungs-Editor, für die lokale Richtlinie mit gpedit.msc, unter Computerkonfiguration > Administrative Vorlagen > TypeWhisper. Empfohlene Einstellungen liegen im Unterordner „Empfohlene Einstellungen (Benutzer können sie ändern)“.
3. Konfiguriere die Einstellungen. Schalter schreiben bei Aktiviert 1 und bei Deaktiviert 0. Text-, Auswahl- und Listeneinstellungen schreiben ihre Werte, wenn sie aktiviert sind, und entfernen sie bei Deaktiviert. Nicht konfiguriert entfernt den Wert immer. Für eine Liste, die nichts erlaubt, trägst du als einzigen Eintrag none ein. Beim Ersetzen einer Liste werden die alten nummerierten Einträge entfernt.
4. Die Richtlinie gilt nach der nächsten Aktualisierung der Gruppenrichtlinie; die laufende App übernimmt sie innerhalb von Sekunden. Sofort aktualisieren:

gpupdate /target:computer

Einstellungen im Editor#

Jedes Paar ist eine Einstellung, daher stehen 18 Registry-Werte in 16 Einstellungen:

Der Unterordner für empfohlene Einstellungen enthält fünf weitere, die dieselben Werte unter Recommended schreiben: Transkriptionsanbieter und -modell (empfohlen), Textmodell-Anbieter und -Modell (empfohlen), Update-Kanal (empfohlen), TypeWhisper bei der Anmeldung starten (empfohlen) und Optionale Hinweise ausblenden (empfohlen).

Intune#

ADMX-Vorlage importieren#

1. Öffne im Intune Admin Center Geräte > Geräte verwalten > Konfiguration, wähle die Registerkarte „ADMX importieren“ und dann „Importieren“. Lade TypeWhisper.admx mit der ADML-Datei für en-US hoch. Der Import akzeptiert nur en-US.
2. Erstelle unter Konfiguration > Erstellen > Neue Richtlinie ein Profil für Windows 10 und höher vom Typ Vorlagen > „Importierte Administrative Vorlagen (Vorschau)“, setze die Einstellungen und weise das Profil Gerätegruppen zu.

Entfernst du eine Einstellung aus dem Profil oder hebst die Zuweisung auf, steht der Wert wieder auf Nicht konfiguriert. Die App behandelt das als Entfernen: Erzwungene Werte verschwinden, und die eigenen Einstellungen der Benutzer gelten wieder. Microsoft führt den Import eigener ADMX-Vorlagen als öffentliche Vorschau; teste ihn zuerst in einem Pilot-Mandanten. Für eine neuere Vorlage, etwa mit Einstellungen aus einem späteren Release, löschst du zuerst die Profile, die die alte Vorlage verwenden, dann die importierte Datei, und importierst danach die neuen Dateien; Intune lehnt eine zweite Datei mit demselben Namespace ab.

Alternative: OMA-URI#

In Mandanten ohne diesen Import nimmst du die ADMX über ein benutzerdefiniertes OMA-URI-Profil auf. Installiere die Vorlage mit ihrem Dateiinhalt als Zeichenfolge:

./Device/Vendor/MSFT/Policy/ConfigOperations/ADMXInstall/TypeWhisper/Policy/TypeWhisperAdmx

Danach sprichst du jede Einstellung über ihren Namen in TypeWhisper.admx an, etwa AllowCloudTranscription oder TranscriptionSelection, mit <enabled/> oder <disabled/> und den <data id="…" value="…"/>-Elementen der Richtlinie. Empfohlene Einstellungen liegen unter der zweiten Kategorie:

./Device/Vendor/MSFT/Policy/Config/TypeWhisper~Policy~TypeWhisper/<PolicyName>
./Device/Vendor/MSFT/Policy/Config/TypeWhisper~Policy~TypeWhisper~TypeWhisper_Recommended/<PolicyName>

Zwei Beispiele:

OMA-URI  ./Device/Vendor/MSFT/Policy/Config/TypeWhisper~Policy~TypeWhisper/AllowCloudTranscription
Wert     <disabled/>

OMA-URI  ./Device/Vendor/MSFT/Policy/Config/TypeWhisper~Policy~TypeWhisper/TranscriptionSelection
Wert     <enabled/><data id="TranscriptionProviderId" value="com.typewhisper.sherpa-onnx"/><data id="TranscriptionModelId" value="parakeet-tdt-0.6b"/>

Prüfe die genauen URIs auf einem Pilotgerät, bevor du sie ausrollst.

Registry und Skripte#

Set-TypeWhisperPolicy.ps1 schreibt dieselben Werte aus einer PowerShell-Sitzung mit Administratorrechten: für Gruppenrichtlinieneinstellungen (Group Policy Preferences), Intune-Skripte, andere Verwaltungswerkzeuge und Tests. Das Skript läuft in Windows PowerShell 5.1 und PowerShell 7 und legt Listen so an, wie App und Vorlage sie erwarten.

# Erzwungene Werte
.\Set-TypeWhisperPolicy.ps1 -Dword @{ UpdateMode = 1; LaunchAtLogin = 1; AllowCloudTranscription = 0 }
.\Set-TypeWhisperPolicy.ps1 -String @{ TranscriptionProviderId = 'com.typewhisper.sherpa-onnx'; TranscriptionModelId = 'parakeet-tdt-0.6b' }
.\Set-TypeWhisperPolicy.ps1 -List @{ AllowedUpdateChannels = @('stable'); AllowedPlugins = @('com.typewhisper.sherpa-onnx') }

# Empfohlene Werte
.\Set-TypeWhisperPolicy.ps1 -Recommended -Dword @{ UpdateChannel = 0 }

# Richtlinie anzeigen, Werte entfernen, alles löschen
.\Set-TypeWhisperPolicy.ps1 -Show
.\Set-TypeWhisperPolicy.ps1 -Remove AllowedPlugins, ManagedLicenseKey
.\Set-TypeWhisperPolicy.ps1 -Clear

Ohne das Skript erreichst du dasselbe mit einfachen Registry-Befehlen:

$policy = 'HKLM:\SOFTWARE\Policies\TypeWhisper'
New-Item -Path $policy -Force | Out-Null
Set-ItemProperty -Path $policy -Name UpdateMode -Value 1 -Type DWord          # nur prüfen
Set-ItemProperty -Path $policy -Name LaunchAtLogin -Value 1 -Type DWord       # mit Windows starten
Set-ItemProperty -Path $policy -Name AllowedUpdateChannelsConfigured -Value 1 -Type DWord
New-Item -Path "$policy\AllowedUpdateChannels" -Force | Out-Null
Set-ItemProperty -Path "$policy\AllowedUpdateChannels" -Name 1 -Value stable -Type String
New-Item -Path "$policy\Recommended" -Force | Out-Null
Set-ItemProperty -Path "$policy\Recommended" -Name UpdateChannel -Value 0 -Type DWord

Wirksame Werte prüfen#

• Einstellungen > Erweitert > Verwaltete Einstellungen zeigt die auf dem Gerät wirksamen Werte und unter „Probleme in der Richtlinie“ alles, was nicht passt: ungültige Werte, unvollständige Paare, fehlende Anbieter oder Modelle und Einschränkungen unter Recommended.
• Gesperrte Einstellungen sagen in der App, dass deine Organisation sie verwaltet. Lässt sich die Richtlinie nicht lesen, meldet der Bereich das, und die App behält die zuletzt bekannten Werte.
• Der Supportbericht (Einstellungen > Erweitert > Support-Diagnose > Supportbericht > „Diagnose exportieren…“) enthält denselben Abschnitt. Benutzer können ihn an dich oder an den TypeWhisper-Support schicken.
• Set-TypeWhisperPolicy.ps1 -Show zeigt, was in der Registry steht.