WEKF_Settings
啟用或停用鍵盤篩選的設定。
語法
class WEKF_Settings {
[Key] string Name;
[Read, Write] string Value;
};
成員
下表列出屬於這個類別的任何方法和屬性。
屬性
| 屬性 | 資料類型 | 限定詞 | 描述 |
|---|---|---|---|
| 名稱 | string | [key] | 指出這個物件所代表的鍵盤篩選設定名稱。 如需有效設定名稱的清單，請參閱一節。 |
| 值 | 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 設定為標準鍵盤上 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()
規格需求
| Windows 版本 | 支援 |
|---|---|
| Windows 首頁 | No |
| Windows 專業版 | No |
| Windows 企業版 | Yes |
| Windows 教育版 | Yes |
| Windows IoT 企業版 | 是的 |