WEKF_Settings

Edições
✅ com suporte IoT Enterprise LTSC
✅ IoT Enterprise
✅ Enterprise LTSC
✅ Enterprise
✅ Education

Habilita ou desabilita as configurações do Filtro de Teclado.

Sintaxe

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

Membros

As tabelas a seguir listam todos os métodos e propriedades que pertencem a essa classe.

Propriedades

Propriedade Tipo de dados Eliminatórias Descrição
Nome string [chave] Indica o nome da configuração de Filtro de Teclado que esse objeto representa. Consulte a seção Observações para obter uma lista de nomes de configuração válidos.
Valor string [ler, escrever] Representa o valor da configuração Nome . O valor não diferencia maiúsculas de minúsculas.
Consulte a seção Observações para obter uma lista de valores válidos para cada configuração.

Comentários

Você deve estar conectado a uma conta de administrador para fazer alterações nessa classe.

Cada objeto WEKF_Settings representa uma única configuração de Filtro de Teclado. Você pode enumerar em todos os objetos WEKF_Settings para ver o valor de todas as configurações de Filtro de Teclado.

A tabela a seguir lista todas as configurações disponíveis para o Filtro de Teclado.

Nome da configuração Descrição
DisableKeyboardFilterForAdministrators Essa configuração especifica se o Filtro de Teclado está habilitado ou desabilitado para contas de administrador. Defina como true para desabilitar o Filtro de Teclado para contas de administrador; Caso contrário, defina como False. Definido como true por padrão.
ForceOffAccessibility Essa configuração especifica se o Filtro de Teclado impede que os usuários habilitem os recursos de Facilidade de Acesso. Defina como true para forçar a desativação dos recursos de Facilidade de Acesso. Defina como false para permitir a habilitação dos recursos de Facilidade de Acesso. Defina como false por padrão.
Alterar essa configuração para false não habilita automaticamente os recursos de Facilidade de Acesso; Você deve habilitá-las manualmente.
BreakoutKeyScanCode Essa configuração especifica o código de verificação da chave que permite que um usuário saia de uma conta bloqueada com o Filtro de Teclado. Um usuário pode pressionar essa tecla cinco vezes consecutivas para alternar para a tela de boas-vindas.
Por padrão, o BreakoutKeyScanCode é definido como o código de verificação para a tecla esquerda do Windows.

Existe uma instância da classe WEKF_Settings para cada configuração válida.

As alterações na configuração DisableKeyboardFilterForAdministrator são aplicadas quando uma conta de administrador entra e se aplicam a todos os aplicativos executados durante a sessão do usuário. Se um usuário sem uma conta de administrador executar um aplicativo como administrador, o filtro de teclado ainda estará habilitado, independentemente da configuração DisableKeyboardFilterForAdministrator .

As alterações na configuração BreakoutKeyScanCode não entram em vigor até que você reinicie o dispositivo.

Se o BreakoutKeyScanCode estiver definido como o código de verificação para a tecla esquerda do Windows ou para a tecla direita do Windows, ambas as teclas do Windows funcionarão como a chave de breakout.

A configuração BreakoutKeyScanCode só se aplica a contas em que o Filtro de Teclado está ativo. Se o código de verificação estiver definido com um valor que não mapeia para nenhuma chave, como 0 (zero), você deverá usar outro método para acessar a tela de Boas-vindas se precisar fazer manutenção no dispositivo, como conectar-se remotamente ou reiniciar o dispositivo se a entrada automática não estiver habilitada.

Importante

Em alguns dispositivos, se a tecla breakout for pressionada muito rapidamente, os pressionamentos de tecla podem não ser registrados. Recomendamos que você inclua uma pequena pausa entre cada pressionamento de tecla de breakout.

Aviso

Ao definir o BreakoutKeyScanCode, certifique-se de usar o código de verificação da chave e não o valor da chave virtual.

Exemplo

O script do Windows PowerShell a seguir demonstra como usar essa classe para modificar a tecla de modo de breakout para o Filtro de Teclado. Este exemplo define a configuração BreakoutKeyScanCode como o código de verificação da tecla Home em um teclado padrão.

#---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()

Referência de provedor WMI de filtro de teclado

Filtro de Teclado