Condividi tramite


WEKF_Settings

Edizioni
✅ supportate IoT Enterprise LTSC
✅ IoT Enterprise
✅ LTSC✅
Enterprise
✅ Education

Abilita o disabilita le impostazioni per Filtro tastiera.

Sintassi

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

Membri

Nelle tabelle seguenti sono elencati tutti i metodi e le proprietà che appartengono a questa classe.

Proprietà

Proprietà Tipo di dati Qualificazioni Descrizione
Nome stringa [chiave] Indica il nome dell'impostazione Filtro tastiera rappresentata da questo oggetto. Per un elenco di nomi di impostazioni validi, vedere la sezione Osservazioni.
Valore stringa [lettura, scrittura] Rappresenta il valore dell'impostazione Nome . Il valore non fa distinzione tra maiuscole e minuscole.
Per un elenco di valori validi per ogni impostazione, vedere la sezione Osservazioni.

Osservazioni

Per apportare modifiche a questa classe, è necessario accedere a un account amministratore.

Ogni oggetto WEKF_Settings rappresenta una singola impostazione filtro tastiera. È possibile enumerare tutti gli oggetti WEKF_Settings per visualizzare il valore di tutte le impostazioni filtro tastiera.

Nella tabella seguente sono elencate tutte le impostazioni disponibili per Filtro tastiera.

Nome dell'impostazione Descrizione
DisableKeyboardFilterForAdministrators Questa impostazione specifica se filtro tastiera è abilitato o disabilitato per gli account amministratore. Impostare su true per disabilitare il filtro da tastiera per gli account amministratore; in caso contrario, impostare su false. Impostare su true per impostazione predefinita.
ForceOffAccessibility Questa impostazione specifica se Filtro tastiera impedisce agli utenti di abilitare le funzionalità di Accessibilità. Impostare su true per forzare la disabilitazione delle funzionalità di Accessibilità. Impostare su false per consentire l'abilitazione delle funzionalità di Accessibilità. Impostare su false per impostazione predefinita.
La modifica di questa impostazione su false non abilita automaticamente le funzionalità di Accessibilità; è necessario abilitarli manualmente.
BreakoutKeyScanCode Questa impostazione specifica il codice di analisi del tasto che consente a un utente di uscire da un account bloccato con filtro da tastiera. Un utente può premere questo tasto consecutivi cinque volte per passare alla schermata iniziale.
Per impostazione predefinita, BreakoutKeyScanCode è impostato sul codice di analisi per il tasto logo Windows sinistro.

Esiste un'istanza della classe WEKF_Settings per ogni impostazione valida.

Le modifiche apportate all'impostazione DisableKeyboardFilterForAdministrator vengono applicate quando un account amministratore accede e si applica a tutte le applicazioni eseguite durante la sessione utente. Se un utente senza un account amministratore esegue un'applicazione come amministratore, il filtro da tastiera è ancora abilitato, indipendentemente dall'impostazione DisableKeyboardFilterForAdministrator .

Le modifiche apportate all'impostazione BreakoutKeyScanCode non diventano effettive finché non si riavvia il dispositivo.

Se BreakoutKeyScanCode è impostato sul codice di analisi per il tasto logo Windows sinistro o il tasto logo Windows destro, entrambi i tasti logo Windows funzioneranno come tasto di interruzione.

L'impostazione BreakoutKeyScanCode si applica solo agli account in cui è attivo Filtro tastiera. Se il codice di analisi è impostato su un valore che non esegue il mapping a alcuna chiave, ad esempio 0 (zero), è necessario usare un altro metodo per accedere alla schermata iniziale se è necessario gestire il dispositivo, ad esempio la connessione remota o il riavvio del dispositivo se l'accesso automatico non è abilitato.

Importante

In alcuni dispositivi, se il tasto di interruzione viene premuto troppo rapidamente, è possibile che i tasti non vengano registrati. È consigliabile includere una leggera pausa tra ogni pressione del tasto di interruzione.

Warning

Quando si imposta BreakoutKeyScanCode, assicurarsi di usare il codice di analisi della chiave e non il valore della chiave virtuale.

Esempio

Lo script di Windows PowerShell seguente illustra come usare questa classe per modificare il tasto della modalità di interruzione per Filtro tastiera. In questo esempio viene impostata l'impostazione BreakoutKeyScanCode sul codice di analisi per il tasto Home su una tastiera 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()

Informazioni di riferimento sul provider WMI filtro tastiera

Filtro tastiera