WEKF_Settings
Éditions
✅ prises en charge IoT Enterprise LTSC
✅ IoT Enterprise
✅ LTSC✅
Enterprise
✅ Éducation
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 | Qualificatifs | Description |
|---|---|---|---|
| Nom | chaîne | [key] | 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 | chaîne | [lire, écrire] | Représente la valeur du paramètre Name . 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 paramètre de filtre clavier unique. Vous pouvez énumérer tous les objets WEKF_Settings pour voir la valeur de tous les paramètres de filtre 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éfinissez 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’ergonomie. Définissez sur true pour forcer la désactivation des fonctionnalités d’ergonomie. Définissez sur false pour autoriser l’activation des fonctionnalités d’ergonomie. Définissez sur false par défaut. La modification de ce paramètre sur false n’active pas automatiquement les fonctionnalités d’ergonomie ; 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 à cinq reprises consécutivement 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. |
Une 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 n’entrent pas en vigueur 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 petit groupe.
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 avez besoin de traiter l’appareil, par exemple en vous connectant à distance ou en redémarrant l’appareil si la connexion automatique n’est pas activée.
Important
Sur certains appareils, si la touche de breakout est enfoncée trop rapidement, il se peut que les pressions sur la touche ne s’inscrivent pas. Nous vous recommandons d’inclure une légère pause entre chaque appui sur la touche breakout.
Warning
Lorsque vous définissez BreakoutKeyScanCode, veillez à utiliser le code d’analyse de la clé, et non la valeur de clé virtuelle.
Exemple
Le script de Windows PowerShell suivant montre comment utiliser cette classe pour modifier la touche de mode breakout pour le filtre clavier. Cet exemple montre comment définir le paramètre BreakoutKeyScanCode sur le code d’analyse de la touche Accueil d’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()
Articles connexes
Informations de référence sur le fournisseur WMI du filtre clavier