WEKF_CustomKey
Ediciones admitidas
✅ IoT Enterprise LTSC
✅ IoT Enterprise
✅ LTSC✅
Enterprise
✅ Education
Agrega o quita combinaciones de teclas definidas de forma personalizada.
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 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 personalizada y permite que Filtro de 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 |
|---|---|---|---|
| Identificación | string | [key] | Nombre de la combinación de teclas personalizada. |
| Habilitado | Booleano | [leer, escribir] | Indica si la clave está bloqueada o desbloqueada. Esta propiedad puede ser uno de los siguientes valores - true Indica que la clave está bloqueada. - falso Indica que la clave no está bloqueada. |
Observaciones
Puede especificar combinaciones de teclas incluyendo las teclas modificadoras en el nombre. Los nombres de modificador más comunes son >Ctrl, >Mayús, >Alt y >Win. No se puede bloquear una combinación de teclas 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 clave 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 >%, el filtro de teclado bloquea >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.
Por ejemplo:
En el código siguiente se muestra cómo agregar o habilitar una combinación de teclas personalizada que el filtro de teclado bloqueará 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"