WEKF_Settings
支援的版本
✅IoT 企業版 LTSC
✅ IoT 企業✅
版 LTSC
✅ 企業
✅教育版
啟用或停用鍵盤篩選器的設定。
語法
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()