WEKF_CustomKey
カスタム定義されたキーの組み合わせを追加または削除します。
構文
class WEKF_CustomKey {
[Static] uint32 Add(
[In] string CustomKey
);
[Static] uint32 Remove(
[In] string CustomKey
);
[Key] string Id;
[Read, Write] boolean Enabled;
};
メンバー
次の表に、このクラスに属するメソッドとプロパティを示します。
メソッド
| メソッド | 説明 |
|---|---|
| WEKF_CustomKey.Add | 新しいカスタム キーの組み合わせを作成し、キーボード フィルターで新しいキーの組み合わせをブロックできるようにします。 |
| WEKF_CustomKey.Remove | 指定されたカスタムキーの組み合わせを削除します。 キーボードフィルターは削除されたキーの組み合わせの禁止を停止します。 |
Properties
| プロパティ | データ型 | 修飾子 | 説明 |
|---|---|---|---|
| Id | string | [key] | カスタムキーの組み合わせの名前です。 |
| Enabled | ブール型 | [read, write] | キーが禁止されているか、ブロック解除されているかを示します。 このプロパティは、次のいずれかの値を指定できます - true は、キーがブロックされていることを示します。 - false はキーがブロックされていないことを示します。 |
解説
名前の中に修飾キーを含めることで、キーの組み合わせを指定できます。 最も一般的な修飾名は、"Ctrl"、"Shift"、"Alt"、"Win" です。 修飾されていないキーの組み合わせを禁止することはできません。 たとえば、"Ctrl + Shift + F" のキーの組み合わせは禁止できますが、"A + D" のキーの組み合わせは禁止できません。
シフトで変更されたキーを禁止するには、そのキーを “Shift” + 変更されていないキーとして入力する必要があります。 例えば、英語キーボードレイアウトで % キーを禁止するには、“Shift+5” と指定する必要があります。 “%” をブロックしようとすると、Keyboard Filter は代わりに “5” を禁止します。
禁止するキーの組み合わせを指定する際には、キーの英語名を使用する必要があります。 指定可能なキー名の一覧は、「キーボードフィルタのキー名」を参照してください。
例
次のコードは、キーボード フィルター用の Windows Management Instrumentation (WMI) プロバイダーを使用して、キーボード フィルターがブロックするカスタム キーを追加または有効にする方法を示しています。 この例では、プロパティを直接変更し、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"
要件
| Windows エディション | サポートされています |
|---|---|
| Windows Home | いいえ |
| Windows Pro | いいえ |
| Windows Enterprise | はい |
| Windows Education | はい |
| Windows IoT Enterprise | はい |