WEKF_Settings
啟用或停用鍵盤篩選的設定。
語法
class WEKF_Settings {
[Key] string Name;
[Read, Write] string Value;
};
成員
下表列出屬於這個類別的任何方法和屬性。
屬性
| 屬性 | 資料類型 | 限定詞 | 描述 |
|---|---|---|---|
| 名稱 | 字串 | [key] | 指出這個物件所代表之鍵盤篩選設定的名稱。 如需有效的設定名稱清單，請參閱一節。 |
| 值 | 字串 | [read， write] | 表示 [名稱] 設定的值。 值不區分大小寫。 如需每個設定的有效值清單，請參閱一節。 |
備註
您必須登入系統管理員帳戶，才能對這個類別進行任何變更。
每個WEKF_設定物件都代表單一鍵盤篩選設定。 您可以列舉所有WEKF_設定物件，以查看所有鍵盤篩選設定的值。
下表列出鍵盤篩選可用的所有設定。
| 設定名稱 | 描述 |
|---|---|
| DisableKeyboardFilterForAdministrators | 此設定會指定系統管理員帳戶是否啟用或停用鍵盤篩選。 設定為 true 以停用系統管理員帳戶的鍵盤篩選，否則設定為 false。 默認設定為 true 。 |
| ForceOffAccessibility | 此設定會指定鍵盤篩選是否阻止使用者啟用 [輕鬆存取] 功能。 設定為 true 以強制停用 [輕鬆存取] 功能。 設定為 false 以允許啟用 [輕鬆存取] 功能。 默認設定為 false 。 將此設定變更為 false 不會自動啟用 [輕鬆存取] 功能;您必須手動啟用這些功能。 |
| BreakoutKeyScanCode | 這個設定會指定金鑰的掃描代碼，讓用戶能夠中斷使用鍵盤篩選鎖定的帳戶。 用戶可以連續五次按下此按鍵，以切換至歡迎畫面。 根據預設，BreakoutKeyScanCode 會設定為左側 Windows 標誌鍵的掃描碼。 |
每個有效設定都有WEKF_設定類別的一個實例。
當系統管理員帳戶登入時，會套用 DisableKeyboardFilterFor 管理員 istrator 設定的變更，並套用至用戶會話期間執行的所有應用程式。 如果沒有系統管理員帳戶的使用者以系統管理員身分執行應用程式，則不論 DisableKeyboardFilterFor 管理員 istrator 設定為何，鍵盤篩選仍會啟用。
在重新啟動裝置之前，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 Home | No |
| Windows 專業版 | No |
| Windows 企業版 | Yes |
| Windows 教育版 | Yes |
| Windows IoT 企業版 | Yes |