WEKF_CustomKey

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	Qualifizierer	BESCHREIBUNG
Id	Zeichenfolge	[Taste]	Der Name der benutzerdefinierten Tastenkombination.
Aktiviert	Boolean	[lesen, schreiben]	Gibt an, ob die Taste blockiert oder deaktiviert wird. Diese Eigenschaft kann einer der folgenden Werte - sein true Gibt an, dass der Schlüssel blockiert ist. - FALSE Gibt an, dass der Schlüssel nicht blockiert ist.

Hinweise

Sie können Tastenkombinationen angeben, indem Sie die Zusatztasten im Namen einschließen. Die gebräuchlichsten Modifizierernamen sind „Strg“, „Umschalt“, „Alt“ und „Win“. Sie können keine Kombination von Nicht-Zusatztasten blockieren. Sie können beispielsweise eine Tastenkombination von „Strg + Umschalt + F“ blockieren, aber Sie können eine Tastenkombination von „A + D“ nicht blockieren.

Wenn Sie eine Umschalttaste blockieren, müssen Sie die Taste als „Umschalt“ + die nicht modifizierte Taste eingeben. Um beispielsweise die %-Taste auf einem englischen Tastaturlayout zu blockieren, 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 Tastenkombination angeben, die blockiert werden soll, müssen Sie die englischen Namen für die Tasten verwenden. Eine Liste der Tastennamen, die Sie angeben können, finden Sie unter Tastennamen des Tastaturfilters.

Beispiel

Der folgende Code zeigt, wie Sie eine benutzerdefinierte Tastenkombination hinzufügen oder aktivieren, den der Tastaturfilter blockiert, indem Sie die WMI-Anbieter (Windows Management Instrumentation) für den Tastaturfilter verwenden. 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"

Anforderungen

Windows-Edition	Unterstützt
Windows Home	Nein
Windows Pro	Nein
Windows Enterprise	Ja
Windows Education	Ja
Windows IoT Enterprise	Ja

Zugehörige Themen

WMI-Anbieterreferenz für Tastaturfilter

Tastennamen für Tastaturfilter