WEKF_Settings

Active ou désactive les paramètres du filtre clavier.

Syntaxe

class WEKF_Settings {
  [Key] string Name;
  [Read, Write] string Value;
};

Membres

Les tableaux suivants répertorient toutes les méthodes et propriétés qui appartiennent à cette classe.

Propriétés

Propriété	Type de données	Qualificateurs	Description
Nom	string	[Clé]	Indique le nom du paramètre Filtre clavier que cet objet représente. Consultez la section Remarques pour obtenir la liste des noms de paramètres valides.
Valeur	string	[lire, écrire]	Représente la valeur du paramètre Nom . La valeur ne respecte pas la casse. Consultez la section Remarques pour obtenir la liste des valeurs valides pour chaque paramètre.

Remarques

Vous devez être connecté à un compte d’administrateur pour apporter des modifications à cette classe.

Chaque objet WEKF_Settings représente un seul paramètre De filtre clavier. Vous pouvez énumérer tous les objets WEKF_Settings pour voir la valeur de tous les paramètres de filtre du clavier.

Le tableau suivant répertorie tous les paramètres disponibles pour le filtre clavier.

Nom du paramètre	Description
DisableKeyboardFilterForAdministrators	Ce paramètre spécifie si le filtre clavier est activé ou désactivé pour les comptes d’administrateur. Définissez sur true pour désactiver le filtre clavier pour les comptes d’administrateur ; sinon, définissez sur false. Défini sur true par défaut.
ForceOffAccessibility	Ce paramètre spécifie si le filtre clavier empêche les utilisateurs d’activer les fonctionnalités d’facilité d’accès. Définissez sur true pour forcer la désactivation des fonctionnalités de facilité d’accès. Définissez sur false pour autoriser l’activation des fonctionnalités d’facilité d’accès. Défini sur false par défaut. La modification de ce paramètre sur false n’active pas automatiquement les fonctionnalités d’facilité d’accès ; vous devez les activer manuellement.
BreakoutKeyScanCode	Ce paramètre spécifie le code d’analyse de la clé qui permet à un utilisateur de sortir d’un compte verrouillé avec le filtre clavier. Un utilisateur peut appuyer sur cette touche consécutivement cinq fois pour basculer vers l’écran d’accueil. Par défaut, BreakoutKeyScanCode est défini sur le code d’analyse de la touche de logo Windows gauche.

Un instance de la classe WEKF_Settings existe pour chaque paramètre valide.

Les modifications apportées au paramètre DisableKeyboardFilterForAdministrator sont appliquées lorsqu’un compte administrateur se connecte et s’appliquent à toutes les applications exécutées pendant la session utilisateur. Si un utilisateur sans compte d’administrateur exécute une application en tant qu’administrateur, le filtre clavier est toujours activé, quel que soit le paramètre DisableKeyboardFilterForAdministrator .

Les modifications apportées au paramètre BreakoutKeyScanCode ne prennent pas effet tant que vous n’avez pas redémarré l’appareil.

Si breakoutKeyScanCode est défini sur le code d’analyse de la touche de logo Windows gauche ou de la touche de logo Windows droite, les deux touches de logo Windows fonctionnent en tant que touche de breakout.

Le paramètre BreakoutKeyScanCode s’applique uniquement aux comptes où le filtre clavier est actif. Si le code d’analyse est défini sur une valeur qui ne correspond à aucune clé, telle que 0 (zéro), vous devez utiliser une autre méthode pour accéder à l’écran d’accueil si vous devez traiter l’appareil, par exemple la connexion à distance ou le redémarrage de l’appareil si la connexion automatique n’est pas activée.

Important

Sur certains appareils, si la touche d’arrêt est enfoncée trop rapidement, il se peut que les touches ne s’inscrivent pas. Nous vous recommandons d’inclure une légère pause entre chaque appui sur la touche de breakout.

Avertissement

Lorsque vous définissez BreakoutKeyScanCode, veillez à utiliser le code d’analyse de la clé, et non la valeur de clé virtuelle.

Exemple

Le script Windows PowerShell suivant montre comment utiliser cette classe pour modifier la touche de mode d’arrêt pour le filtre clavier. Cet exemple montre comment définir le paramètre BreakoutKeyScanCode sur le code d’analyse de la touche Accueil sur un clavier standard.

#---Define variables---

$COMPUTER = "localhost"
$NAMESPACE = "root\standardcimv2\embedded"

# Define the decimal scan code of the Home key

$HomeKeyScanCode = 71

# Get the BreakoutKeyScanCode setting from WEKF_Settings

$BreakoutMode = get-wmiobject -class wekf_settings -namespace $NAMESPACE | where {$_.name -eq "BreakoutKeyScanCode"}

# Set the breakout key to the Home key.

$BreakoutMode.value = $HomeKeyScanCode

# Push the change into the WMI configuration. You must restart your device before this change takes effect.

$BreakoutMode.put()

Spécifications

Édition Windows	Pris en charge
Windows Famille	Non
Windows Pro	Non
Windows Entreprise	Oui
Windows Éducation	Oui
Windows IoT Entreprise	Oui

Rubriques connexes

Informations de référence sur le fournisseur WMI du filtre clavier

Filtre de clavier