WEKF_Settings
Unterstützte Editionen
✅ IoT Enterprise LTSC
✅ IoT Enterprise
✅ Enterprise LTSC
✅ Enterprise
✅ Education
Aktiviert oder deaktiviert Einstellungen für den Tastaturfilter.
Syntax
class WEKF_Settings {
[Key] string Name;
[Read, Write] string Value;
};
Member
In den folgenden Tabellen sind alle Methoden und Eigenschaften aufgeführt, die zu dieser Klasse gehören.
Eigenschaften
| Eigenschaft | Datentyp | Qualifikation | Beschreibung |
|---|---|---|---|
| Name | string | [Schlüssel] | Gibt den Namen der Tastaturfiltereinstellung an, die dieses Objekt darstellt. Eine Liste der gültigen Einstellungsnamen finden Sie im Abschnitt Hinweise. |
| Wert | string | [lesen, schreiben] | Stellt den Wert der Einstellung Name dar. Bei dem Wert wird die Groß-/Kleinschreibung nicht beachtet.
Eine Liste der gültigen Werte für jede Einstellung finden Sie im Abschnitt Hinweise. |
Hinweise
Sie müssen bei einem Administratorkonto angemeldet sein, um Änderungen an dieser Klasse vornehmen zu können.
Jedes WEKF_Settings-Objekt stellt eine einzelne Tastaturfiltereinstellung dar. Sie können alle WEKF_Settings Objekte auflisten, um den Wert aller Tastaturfiltereinstellungen anzuzeigen.
In der folgenden Tabelle sind alle einstellungen aufgeführt, die für den Tastaturfilter verfügbar sind.
| Einstellungsname | Beschreibung |
|---|---|
| DisableKeyboardFilterForAdministrators | Diese Einstellung gibt an, ob der Tastaturfilter für Administratorkonten aktiviert oder deaktiviert ist. Legen Sie diese Einstellung auf true fest, um den Tastaturfilter für Administratorkonten zu deaktivieren. andernfalls auf false festgelegt. Standardmäßig auf TRUE festgelegt . |
| ForceOffAccessibility | Diese Einstellung gibt an, ob der Tastaturfilter Benutzer daran hindert, Funktionen für erleichterte Bedienung zu aktivieren. Legen Sie auf true fest, um die Deaktivierung der Features für erleichterte Bedienung zu erzwingen. Legen Sie diesen Wert auf false fest, um das Aktivieren der Features für erleichterte Bedienung zu ermöglichen. Standardmäßig auf false festgelegt . Wenn Sie diese Einstellung in "false " ändern, werden funktionen für erleichterte Bedienung nicht automatisch aktiviert. Sie müssen sie manuell aktivieren. |
| BreakoutKeyScanCode | Diese Einstellung gibt den Scancode des Schlüssels an, der es einem Benutzer ermöglicht, aus einem Konto auszubrechen, das mit tastaturfiltergesperrt ist. Ein Benutzer kann diese Taste fünfmal nacheinander drücken, um zum Willkommensbildschirm zu wechseln. Standardmäßig ist BreakoutKeyScanCode auf den Scancode für die linke Windows-Logo-Taste festgelegt. |
Eine instance der WEKF_Settings-Klasse ist für jede gültige Einstellung vorhanden.
Änderungen an der Einstellung DisableKeyboardFilterForAdministrator werden angewendet, wenn sich ein Administratorkonto anmeldet, und gelten für alle Anwendungen, die während der Benutzersitzung ausgeführt werden. Wenn ein Benutzer ohne Administratorkonto eine Anwendung als Administrator ausführt, ist der Tastaturfilter weiterhin aktiviert, unabhängig von der Einstellung DisableKeyboardFilterForAdministrator .
Änderungen an der Einstellung BreakoutKeyScanCode werden erst wirksam, wenn Sie das Gerät neu starten.
Wenn breakoutKeyScanCode auf den Scancode für die linke Windows-Logo-Taste oder die rechte Windows-Logo-Taste festgelegt ist, funktionieren beide Windows-Logo-Tasten als Breakout-Taste.
Die Einstellung BreakoutKeyScanCode gilt nur für Konten, bei denen tastaturfilter aktiv ist. Wenn der Scancode auf einen Wert festgelegt ist, der keinem Schlüssel zugeordnet ist, z. B. 0 (Null), müssen Sie eine andere Methode verwenden, um auf den Willkommensbildschirm zuzugreifen, wenn Sie das Gerät bedienen müssen, z. B. eine Remoteverbindung herstellen oder das Gerät neu starten, wenn die automatische Anmeldung nicht aktiviert ist.
Wichtig
Wenn die Breakout-Taste auf einigen Geräten zu schnell gedrückt wird, wird die Taste möglicherweise nicht registriert. Es wird empfohlen, zwischen jedem Drücken der Breakouttaste eine leichte Pause einzufügen.
Warnung
Achten Sie beim Festlegen von BreakoutKeyScanCode darauf, den Scancode des Schlüssels und nicht den Wert des virtuellen Schlüssels zu verwenden.
Beispiel
Das folgende Windows PowerShell Skript veranschaulicht, wie diese Klasse verwendet wird, um die Breakoutmodustaste für Tastaturfilter zu ändern. In diesem Beispiel wird die Einstellung BreakoutKeyScanCode auf den Scancode für die Taste Home auf einer Standardtastatur festgelegt.
#---Define variables---
$COMPUTER = "localhost"
$NAMESPACE = "root\standardcimv2\embedded"
# Define the decimal scan code of the Home key
$HomeKeyScanCode = 71
# Get the BreakoutKeyScanCode setting from WEKF_Settings
$BreakoutMode = get-wmiobject -class wekf_settings -namespace $NAMESPACE | where {$_.name -eq "BreakoutKeyScanCode"}
# Set the breakout key to the Home key.
$BreakoutMode.value = $HomeKeyScanCode
# Push the change into the WMI configuration. You must restart your device before this change takes effect.
$BreakoutMode.put()