WEKF_Settings
启用或禁用键盘筛选器的设置。
语法
class WEKF_Settings {
[Key] string Name;
[Read, Write] string Value;
};
成员
下表列出了属于此类的任何方法和属性。
属性
| 属性 | 数据类型 | 限定符 | 说明 |
|---|---|---|---|
| 名称 | string | [键] | 指示此对象表示的键盘筛选器设置的名称。 有关有效设置名称的列表，请参阅“备注”部分。 |
| 值 | string | [读，写] | 表示“名称”设置的值。 此值不区分大小写。 有关每个设置的有效值列表，请参阅“备注”部分。 |
注解
必须登录管理员帐户才能对此类进行更改。
每个 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”设置设置为标准键盘上“开始”键的扫描代码。
#---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()
要求
| Windows 版本 | 支持 |
|---|---|
| Windows 家庭版 | 否 |
| Windows 专业版 | 否 |
| Windows 企业版 | 是 |
| Windows 教育版 | 是 |
| Windows IoT 企业版 | 是 |