WEKF_Settings

  • 아티클

키보드 필터에 대한 설정을 사용하거나 사용하지 않도록 설정합니다.

구문

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

구성원

다음 표에는 이 클래스에 속하는 모든 메서드와 속성이 나열되어 있습니다.

속성

속성 데이터 형식 한정자 설명
이름 문자열 [key] 이 개체가 나타내는 키보드 필터 설정의 이름을 나타냅니다. 유효한 설정 이름 목록은 설명 섹션을 참조하세요.
값 문자열 [read, write] 이름 설정의 값을 나타냅니다. 이 값은 대/소문자를 구분하지 않습니다.
각 설정에 대한 유효한 값 목록은 주의 섹션을 참조하세요.

설명

이 클래스를 변경하려면 관리자 계정에 로그인해야 합니다.

각 WEKF_Settings 개체는 단일 키보드 필터 설정을 나타냅니다. 모든 WEKF_Settings 개체를 열거하여 모든 키보드 필터 설정의 값을 볼 수 있습니다.

다음 표에는 키보드 필터에 사용할 수 있는 모든 설정이 나와 있습니다.

설정 이름 설명
DisableKeyboardFilterForAdministrators 이 설정은 관리자 계정에 키보드 필터를 사용할지 여부를 지정합니다. 관리자 계정에 키보드 필터를 사용하지 않도록 설정하려면 true로 설정합니다. 그렇지 않으면 false로 설정합니다. 기본적으로 true로 설정됩니다.
ForceOffAccessibility 이 설정은 키보드 필터에서 사용자의 접근성 기능 사용을 차단하는지 여부를 지정합니다. 접근성 기능을 강제로 사용하지 않도록 설정하려면 true로 설정합니다. 접근성 기능을 사용하도록 설정하는 것을 허용하려면 false로 설정합니다. 기본적으로 false 로 설정합니다.
이 설정을 false 로 변경해도 접근성 기능이 자동으로 활성화되지는 않습니다. 수동으로 사용하도록 설정해야 합니다.
BreakoutKeyScanCode 이 설정은 사용자가 키보드 필터로 잠긴 계정을 풀 수 있도록 하는 키의 스캔 코드를 지정합니다. 사용자는 이 키를 5번 연속으로 눌러 시작 화면으로 전환할 수 있습니다.
기본적으로 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 Home No
Windows Pro No
Windows Enterprise Yes
Windows Education Yes
Windows IoT Enterprise 예

키보드 필터 WMI 공급자 참조

키보드 필터