WEKF_Settings
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 | Qualificadores | Descrição |
|---|---|---|---|
| Nome | string | [key] | Indica o nome da configuração Filtro de teclado que esse objeto representa. Consulte a seção Comentários para obter uma lista de nomes de configuração válidos. |
| Valor | string | [ler, escrever] | Representa o valor da configuração Name . O valor não diferencia maiúsculas de minúsculas. Consulte a seção Comentários 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 todos os objetos WEKF_Settings para ver o valor de todas as configurações do 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 desativar o Filtro de teclado para contas de administrador, caso contrário, defina como false. Defina 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á-los 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 consecutivamente cinco vezes para alternar para a tela de boas-vindas. Por padrão, o BreakoutKeyScanCode é definido como o código de verificação da tecla do logotipo esquerdo 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 aplica 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 do logotipo esquerdo do Windows ou a tecla do logotipo do Windows direita, ambas as teclas do logotipo do Windows funcionarão como a chave de separação.
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 como um valor que não mapeie para nenhuma chave, como 0 (zero), você deverá usar outro método para acessar a tela de boas-vindas se precisar fazer a manutenção do 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, as teclas pressionadas podem não registrar. Recomendamos que você inclua uma pequena pausa entre cada 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 divisão 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()
Requisitos
| Edição do Windows | Com suporte |
|---|---|
| Windows Home | Não |
| Windows Pro | Não |
| Windows Enterprise | Sim |
| Educação do Windows | Sim |
| Windows IoT Enterprise | Yes |