WEKF_CustomKey
Unterstützte Editionen
✅ IoT Enterprise LTSC
✅ IoT Enterprise
✅ Enterprise LTSC
✅ Enterprise
✅ Education
Fügt benutzerdefinierte Tastenkombinationen hinzu oder entfernt sie.
Syntax
class WEKF_CustomKey {
[Static] uint32 Add(
[In] string CustomKey
);
[Static] uint32 Remove(
[In] string CustomKey
);
[Key] string Id;
[Read, Write] boolean Enabled;
};
Member
In den folgenden Tabellen sind alle Methoden und Eigenschaften aufgeführt, die zu dieser Klasse gehören.
Methoden
| Methoden | Beschreibung |
|---|---|
| WEKF_CustomKey.Add | Erstellt eine neue benutzerdefinierte Tastenkombination und aktiviert den Tastaturfilter, um die neue Tastenkombination zu blockieren. |
| WEKF_CustomKey.Remove | Entfernt die angegebene benutzerdefinierte Tastenkombination. Der Tastaturfilter blockiert nicht mehr die Tastenkombination, die entfernt wurde. |
Eigenschaften
| Eigenschaft | Datentyp | Qualifikation | Beschreibung |
|---|---|---|---|
| Id | string | [Schlüssel] | Der Name der benutzerdefinierten Tastenkombination. |
| Ermöglichte | Boolesch | [lesen, schreiben] | Gibt an, ob der Schlüssel blockiert oder die Blockierung aufgehoben wird. Diese Eigenschaft kann einer der folgenden Werte - sein true Gibt an, dass der Schlüssel blockiert ist. - FALSCH Gibt an, dass der Schlüssel nicht blockiert ist. |
Hinweise
Sie können Tastenkombinationen angeben, indem Sie die Modifizierertasten in den Namen einschließen. Die am häufigsten verwendeten Modifizierernamen sind >STRG, >UMSCHALT, >ALT und >Win. Sie können eine Kombination von Nicht-Modifizierertasten nicht blockieren. Beispielsweise können Sie eine Tastenkombination von >STRG+>UMSCHALT+>F blockieren, aber sie können keine Tastenkombination von >A+>D blockieren.
Wenn Sie eine >geänderte UMSCHALTTASTE blockieren, müssen Sie die Taste als >UMSCHALT + unveränderte Taste eingeben. Wenn Sie beispielsweise die >% -Taste auf einem englischen Tastaturlayout blockieren möchten, müssen Sie die Taste als >UMSCHALT+>5 angeben. Der Versuch, %zu blockieren>, führt dazu, dass der Tastaturfilter stattdessen 5 blockiert>.
Wenn Sie die zu blockierende Tastenkombination angeben, müssen Sie die englischen Namen für die Schlüssel verwenden. Eine Liste der Tastennamen, die Sie angeben können, finden Sie unter Tastaturfiltertastennamen.
Beispiel
Der folgende Code veranschaulicht das Hinzufügen oder Aktivieren einer benutzerdefinierten Tastenkombination, die der Tastaturfilter mithilfe der WMI-Anbieter (Windows Management Instrumentation) für den Tastaturfilter blockiert. In diesem Beispiel werden die Eigenschaften direkt geändert und keine der in WEKF_CustomKey definierten Methoden aufgerufen.
<#
.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"