WEKF_Settings
Habilita o deshabilita la configuración del filtro de teclado.
Sintaxis
class WEKF_Settings {
[Key] string Name;
[Read, Write] string Value;
};
Miembros
En las tablas siguientes se enumeran todos los métodos y propiedades que pertenecen a esta clase.
Propiedades
| Propiedad | Tipo de datos | Calificadores | Descripción |
|---|---|---|---|
| Nombre | string | [key] | Indica el nombre de la configuración Filtro de teclado que representa este objeto. Consulte la sección Comentarios para obtener una lista de nombres de configuración válidos. |
| Valor | string | [lectura, escritura] | Representa el valor de la configuración Nombre . El valor no distingue mayúsculas de minúsculas. Consulte la sección Comentarios para obtener una lista de valores válidos para cada configuración. |
Comentarios
Debe haber iniciado sesión en una cuenta de administrador para realizar cualquier cambio en esta clase.
Cada objeto WEKF_Settings representa un valor de filtro de teclado único. Puede enumerar todos los objetos WEKF_Settings para ver el valor de todas las opciones de filtro de teclado.
En la tabla siguiente se enumeran todas las configuraciones disponibles para el filtro de teclado.
| Nombre del valor | Descripción |
|---|---|
| DisableKeyboardFilterForAdministrators | Esta configuración especifica si el filtro de teclado está habilitado o deshabilitado para las cuentas de administrador. Establézcalo en true para deshabilitar el filtro de teclado para las cuentas de administrador; de lo contrario, establezca en false. Establézcalo en true de forma predeterminada. |
| ForceOffAccessibility | Esta configuración especifica si el filtro de teclado impide que los usuarios habiliten las características de accesibilidad. Establézcalo en true para forzar la deshabilitación de las características de accesibilidad. Establézcalo en false para permitir habilitar las características de facilidad de acceso. Establézcalo en false de forma predeterminada. El cambio de esta configuración a false no habilita automáticamente las características de accesibilidad; debe habilitarlos manualmente. |
| BreakoutKeyScanCode | Esta configuración especifica el código de examen de la tecla que permite al usuario interrumpir una cuenta que está bloqueada con el filtro de teclado. Un usuario puede presionar esta tecla de forma consecutiva cinco veces para cambiar a la pantalla de bienvenida. De forma predeterminada, BreakoutKeyScanCode se establece en el código de examen de la tecla izquierda del logotipo de Windows. |
Existe una instancia de la clase WEKF_Settings para cada configuración válida.
Los cambios realizados en la configuración DisableKeyboardFilterForAdministrator se aplican cuando una cuenta de administrador inicia sesión y se aplica a todas las aplicaciones que se ejecutan durante la sesión del usuario. Si un usuario sin una cuenta de administrador ejecuta una aplicación como administrador, el filtro de teclado todavía está habilitado, independientemente de la configuración DisableKeyboardFilterForAdministrator .
Los cambios realizados en la configuración BreakoutKeyScanCode no surten efecto hasta que reinicie el dispositivo.
Si BreakoutKeyScanCode se establece en el código de examen para la tecla del logotipo izquierdo de Windows o la tecla del logotipo de Windows derecha, ambas teclas del logotipo de Windows funcionarán como la tecla de interrupción.
La configuración BreakoutKeyScanCode solo se aplica a las cuentas en las que el filtro de teclado está activo. Si el código de examen se establece en un valor que no se asigna a ninguna clave, como 0 (cero), debe usar otro método para acceder a la pantalla de bienvenida si necesita atender el dispositivo, como la conexión remota o reiniciar el dispositivo si no está habilitado el inicio de sesión automático.
Importante
En algunos dispositivos, si la tecla de interrupción se presiona demasiado rápidamente, es posible que la tecla no se registre. Se recomienda incluir una ligera pausa entre cada pulsación de tecla de interrupción.
Advertencia
Al establecer BreakoutKeyScanCode, asegúrese de usar el código de examen de la clave y no el valor de la clave virtual.
Ejemplo
El siguiente script de Windows PowerShell muestra cómo usar esta clase para modificar la tecla de modo de interrupción del filtro de teclado. En este ejemplo se establece la configuración BreakoutKeyScanCode en el código de examen de la tecla Inicio en un teclado estándar.
#---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()
Requisitos
| Edición de Windows | Compatible |
|---|---|
| Windows Home | No |
| Windows Pro | No |
| Windows Enterprise | Sí |
| Windows Education | Sí |
| Windows IoT Enterprise | Sí |