WEKF_Settings
支持的版本
✅IoT 企业 LTSC
✅ IoT 企业
✅版 LTSC
✅ 企业教育版
✅
启用或禁用键盘筛选器的设置。
语法
class WEKF_Settings {
[Key] string Name;
[Read, Write] string Value;
};
成员
下表列出了属于此类的任何方法和属性。
属性
| 属性 | 数据类型 | 限定 符 | 描述 |
|---|---|---|---|
| 名字 | 字符串 | [key] | 指示此对象表示的键盘筛选器设置的名称。 有关有效设置名称的列表，请参阅“备注”部分。 |
| 值 | 字符串 | [读取、写入] | 表示 “名称” 设置的值。 该值不区分大小写。
有关每个设置的有效值的列表，请参阅“备注”部分。 |
备注
必须登录到管理员帐户才能对此类进行任何更改。
每个 WEKF_Settings 对象表示单个键盘筛选器设置。 可以枚举所有 WEKF_Settings 对象，以查看所有键盘筛选器设置的值。
下表列出了可用于键盘筛选器的所有设置。
| 设置名称 | 描述 |
|---|---|
| DisableKeyboardFilterForAdministrators | 此设置指定为管理员帐户启用或禁用键盘筛选器。 设置为 true 可禁用管理员帐户的键盘筛选器;否则，将 设置为 false。 默认情况下，设置为 true 。 |
| ForceOffAccessibility | 此设置指定键盘筛选器是否阻止用户启用“轻松访问”功能。 设置为 true 可强制禁用“轻松访问”功能。 设置为 false 以允许启用“轻松访问”功能。 默认情况下，设置为 false 。 将此设置更改为 false 不会自动启用“轻松访问”功能;必须手动启用它们。 |
| BreakoutKeyScanCode | 此设置指定密钥的扫描代码，使用户能够突破使用键盘筛选器锁定的帐户。 用户可以连续按此键五次切换到“欢迎”屏幕。 默认情况下，BreakoutKeyScanCode 设置为左侧 Windows 徽标键的扫描代码。 |
每个有效设置都存在 WEKF_Settings 类的一个实例。
对 DisableKeyboardFilterForAdministrator 设置的更改在管理员帐户登录时应用，并应用于在用户会话期间运行的所有应用程序。 如果没有管理员帐户的用户以管理员身份运行应用程序，则无论 DisableKeyboardFilterForAdministrator 设置如何，键盘筛选器仍会启用。
对 BreakoutKeyScanCode 设置的更改在重启设备之前不会生效。
如果将 BreakoutKeyScanCode 设置为左侧 Windows 徽标键或右侧 Windows 徽标键的扫描代码，则这两个 Windows 徽标键将用作分行键。
BreakoutKeyScanCode 设置仅适用于键盘筛选器处于活动状态的帐户。 如果扫描代码设置为未映射到任何键的值（例如 0 (零) ），则必须使用其他方法来访问欢迎屏幕（如果需要为设备提供服务，例如远程连接），或者在未启用自动登录的情况下重启设备。
重要提示
在某些设备上，如果突破键按下得太快，则按键可能无法注册。 建议在每次按突破键之间包含一个轻微的暂停。
警告
设置 BreakoutKeyScanCode 时，请确保使用密钥的扫描代码，而不是虚拟密钥值。
示例
以下Windows PowerShell脚本演示如何使用此类修改键盘筛选器的分流模式键。 本示例将 BreakoutKeyScanCode 设置设置为标准键盘上 Home 键的扫描代码。
#---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()