次の方法で共有

WEKF_Settings

  • [アーティクル]
  • 適用対象:
    ✅ Windows 11, ✅ Windows 10

サポートされているエディション
✅ IoT Enterprise LTSC
✅ IoT Enterprise
✅ Enterprise LTSC
✅ Enterprise
✅ Education

キーボード フィルターの設定を有効または無効にします。

構文

class WEKF_Settings {
  [Key] string Name;
  [Read, Write] string Value;
};

Members

次の表に、このクラスに属するすべてのメソッドとプロパティを示します。

プロパティ

プロパティ データ型 修飾子 説明
名前 文字列 [キー] このオブジェクトが表すキーボード フィルター設定の名前を示します。 有効な設定名の一覧については、「解説」セクションを参照してください。
Value 文字列 [読み取り、書き込み] [名前] 設定の値を表します。 値では大文字と小文字は区別されません。
各設定の有効な値の一覧については、「解説」セクションを参照してください。

注釈

このクラスに変更を加えるには、管理者アカウントにサインインする必要があります。

各 WEKF_Settings オブジェクトは、1 つのキーボード フィルター設定を表します。 すべての WEKF_Settings オブジェクトを列挙して、すべてのキーボード フィルター設定の値を確認できます。

次の表に、キーボード フィルターで使用できるすべての設定を示します。

設定名 説明
DisableKeyboardFilterForAdministrators この設定では、管理者アカウントでキーボード フィルターを有効または無効にするかどうかを指定します。 管理者アカウントのキーボード フィルターを無効にするには 、true に設定します。それ以外の場合は、false に設定 します。 既定では true に設定されます。
ForceOffAccessibility この設定は、キーボード フィルターによってユーザーが簡単操作機能を有効にできないようにするかどうかを指定します。 簡単操作機能を強制的に無効にするには 、true に設定します。 [簡単操作] 機能を有効にするには 、false に設定します。 既定では false に設定します。
この設定を false に変更しても、簡単操作機能は自動的に有効になりません。手動で有効にする必要があります。
ブレークアウトKeyScanCode この設定は、ユーザーがキーボード フィルターでロックダウンされたアカウントから抜け出すキーのスキャン コードを指定します。 ユーザーは、このキーを 5 回連続して押してようこそ画面に切り替えることができます
既定では、ブレークアウトKeyScanCode は左側の Windows ロゴ キーのスキャン コードに設定されます。

有効な設定ごとに 、WEKF_Settings クラスのインスタンスが 1 つ存在します。

DisableKeyboardFilterForAdministrator 設定の変更は、管理者アカウントがサインインするときに適用され、ユーザー セッション中に実行されるすべてのアプリケーションに適用されます。 管理者アカウントを持たないユーザーが管理者としてアプリケーションを実行する場合、 DisableKeyboardFilterForAdministrator 設定に関係なく、キーボード フィルターは引き続き有効になります。

デバイスを再起動するまで、 ブレークアウトKeyScanCode 設定の変更は有効になりません。

ブレークアウトキーScanCodeが左のWindowsロゴキーまたは右のWindowsロゴキーのスキャンコードに設定されている場合、両方のWindowsロゴキーがブレークアウトキーとして機能します。

ブレークアウトKeyScanCode 設定は、キーボード フィルターがアクティブなアカウントにのみ適用されます。 スキャン コードが 0 (ゼロ) などのキーにマップされない値に設定されている場合は、リモート接続などのデバイスにサービスを提供する必要がある場合、または自動サインインが有効になっていない場合にデバイスを再起動する必要がある場合は、別のメソッドを使用してようこそ画面にアクセスする必要があります。

重要

一部のデバイスでは、ブレークアウト キーがあまりにも速く押されると、キーが押されても登録されない可能性があります。 ブレークアウト キーを押すたびに少し一時停止することをお勧めします。

Warning

BreakoutKeyScanCode を設定するときは、仮想キーの値ではなく、キーのスキャン コードを使用してください。

例

次のWindows PowerShell スクリプトは、このクラスを使用してキーボード フィルターのブレークアウト モード キーを変更する方法を示しています。 次の使用例は、標準キーボードの Home キーのスキャン コードに 、ブレークアウトキーScanCode 設定を設定します。

#---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()

キーボード フィルター WMI プロバイダー リファレンス

キーボード フィルター