WEKF_CustomKey
Agrega o quita combinaciones de teclas definidas por el personalizado.
Sintaxis
class WEKF_CustomKey {
[Static] uint32 Add(
[In] string CustomKey
);
[Static] uint32 Remove(
[In] string CustomKey
);
[Key] string Id;
[Read, Write] boolean Enabled;
};
Miembros
En las tablas siguientes se enumeran todos los métodos y propiedades que pertenecen a esta clase.
Métodos
| Métodos | Descripción |
|---|---|
| WEKF_CustomKey.Add | Crea una nueva combinación de teclas y habilita que el filtro del teclado bloquee la nueva combinación de teclas. |
| WEKF_CustomKey.Remove | Quita la combinación de teclas personalizada especificada. El filtro de teclado deja de bloquear la combinación de teclas que se quitó. |
Propiedades
| Propiedad | Tipo de datos | Calificadores | Descripción |
|---|---|---|---|
| Id | string | [key] | Nombre de la combinación de teclas personalizada. |
| Habilitado | Booleano | [lectura, escritura] | Indica si la clave está bloqueada o desbloqueada. Esta propiedad puede ser uno de los siguientes valores - true Indica que la clave está bloqueada. - false Indica que la clave no está bloqueada. |
Comentarios
Puede especificar combinaciones de teclas mediante la inclusión de las teclas modificadoras en el nombre. Los nombres modificadores más comunes son "Ctrl", "Mayús", "Alt" y "Win". No se puede bloquear una combinación de claves no modificadoras. Por ejemplo, puede bloquear una combinación de teclas de "Ctrl+Mayús+F", pero no puede bloquear una combinación de teclas de "A+D".
Al bloquear una tecla modificada por mayús, debe escribir la tecla como "Mayús" + la clave sin modificar. Por ejemplo, para bloquear la tecla % en un diseño de teclado en inglés, debe especificar la tecla como "Mayús+5". Al intentar bloquear "%", se produce el bloqueo del filtro de teclado "5" en su lugar.
Al especificar la combinación de teclas que se va a bloquear, debe usar los nombres en inglés para las claves. Para obtener una lista de los nombres de clave que puede especificar, consulte Nombres de teclas de filtro de teclado.
Ejemplo
En el código siguiente se muestra cómo agregar o habilitar una combinación de teclas personalizada que bloqueará el filtro de teclado mediante los proveedores de Instrumental de administración de Windows (WMI) para el filtro de teclado. En este ejemplo se modifican las propiedades directamente y no se llama a ninguno de los métodos definidos en WEKF_CustomKey.
<#
.Synopsis
This script shows how to use the WMI provider to enable and add
Keyboard Filter rules through Windows PowerShell on the local computer.
.Parameter ComputerName
Optional parameter to specify a remote machine that this script should
manage. If not specified, the script will execute all WMI operations
locally.
#>
param (
[String] $ComputerName
)
$CommonParams = @{"namespace"="root\standardcimv2\embedded"}
$CommonParams += $PSBoundParameters
function Enable-Custom-Key($Id) {
<#
.Synopsis
Toggle on a Custom Key Keyboard Filter Rule
.Description
Use Get-WMIObject to enumerate all WEKF_CustomKey instances,
filter against key value "Id", and set that instance's "Enabled"
property to 1/true.
In the case that the Custom instance does not exist, add a new
instance of WEKF_CustomKey using Set-WMIInstance.
.Example
Enable-Custom-Key "Ctrl+V"
Enable filtering of the Ctrl + V sequence.
#>
$custom = Get-WMIObject -class WEKF_CustomKey @CommonParams |
where {
$_.Id -eq "$Id"
};
if ($custom) {
# Rule exists. Just enable it.
$custom.Enabled = 1;
$custom.Put() | Out-Null;
"Enabled Custom Filter $Id.";
} else {
Set-WMIInstance `
-class WEKF_CustomKey `
-argument @{Id="$Id"} `
@CommonParams | Out-Null
"Added Custom Filter $Id.";
}
}
# Some example uses of the function defined above.
Enable-Custom-Key "Ctrl+V"
Enable-Custom-Key "Numpad0"
Enable-Custom-Key "Shift+Numpad1"
Requisitos
| Edición de Windows | Compatible |
|---|---|
| Windows Home | No |
| Windows Pro | No |
| Windows Enterprise | Sí |
| Windows Education | Sí |
| Windows IoT Enterprise | Sí |