UWF_RegistryFilter

Artigo
05/21/2024

Adiciona ou remove exclusões do Registro da filtragem do Filtro de Gravação Unificado (UWF) e também confirma as alterações do Registro.

Sintaxe

class UWF_RegistryFilter{
    [key, Read] boolean CurrentSession;
    [Read, Write] boolean PersistDomainSecretKey;
    [Read, Write] boolean PersistTSCAL;

    UInt32 AddExclusion(
        string RegistryKey
    );
    UInt32 RemoveExclusion(
        string RegistryKey
    );
    UInt32 FindExclusion(
        [in] string RegistryKey,
        [out] boolean bFound
    );
    UInt32 GetExclusions(
        [out, EmbeddedInstance("UWF_ExcludedRegistryKey")] string ExcludedKeys[]
    );
    UInt32 CommitRegistry(
        [in] string RegistryKey,
        [in] string ValueName
    );
    UInt32 CommitRegistryDeletion(
        string Registrykey,
        string ValueName
    );
};

Membros

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

Método	Descrição
UWF_RegistryFilter.AddExclusion	Adiciona uma chave do Registro à lista de exclusão do Registro para UWF.
UWF_RegistryFilter.CommitRegistry	Confirma as alterações na chave e no valor do Registro especificados.
UWF_RegistryFilter.CommitRegistryDeletion	Exclui a chave do registro especificada ou o valor do registro e confirma a exclusão.
UWF_RegistryFilter.FindExclusion	Determina se uma chave do Registro específica é excluída de ser filtrada pelo UWF.
UWF_RegistryFilter.GetExclusions	Recupera todas as exclusões de chave do Registro de um sistema protegido pelo UWF
UWF_RegistryFilter.RemoveExclusion	Remove uma chave do Registro da lista de exclusão do Registro para o Filtro de Gravação Unificado (UWF).

Propriedades

Propriedade	Tipo de dados	Qualificadores	Descrição
CurrentSession	Booliano	[chave, ler]	Indica para qual sessão o objeto contém configurações. - True se as configurações forem para a sessão - atual False se as configurações forem para a próxima sessão que se segue a uma reinicialização.
PersistDomainSecretKey	Booliano	[ler, escrever]	Indica se a chave do Registro do segredo de domínio está na lista de exclusão do Registro. Se a chave do Registro não estiver na lista de exclusão, as alterações não serão persistentes após uma reinicialização. - True para incluir na lista de exclusão - Caso contrário , False.
PersistTSCAL	Booliano	[ler, escrever]	Indica se a chave do Registro TSCAL (Licença de Acesso para Cliente) do Terminal Server está na lista de exclusão do Registro UWF. Se a chave do Registro não estiver na lista de exclusão, as alterações não serão persistentes após uma reinicialização. - True para incluir na lista de exclusão- Caso contrário, defina como False

Comentários

As adições ou remoções de exclusões do Registro, incluindo alterações nos valores de PersistDomainSecretKey e PersistTSCAL, entram em vigor após a próxima reinicialização na qual o UWF está habilitado.

Você só pode adicionar chaves do Registro na raiz do Registro HKLM à lista de exclusão do Registro UWF.

Você também pode usar UWF_RegistryFilter para excluir a chave do Registro secreta de domínio e a chave do Registro TSCAL da filtragem UWF.

Exemplo

O exemplo a seguir demonstra como gerenciar exclusões de registro UWF usando o provedor WMI (Instrumentação de Gerenciamento do Windows) em um script do PowerShell.

O script do PowerShell cria quatro funções e, em seguida, demonstra como usá-las.

A primeira função, Get-RegistryExclusions, exibe uma lista de exclusões do Registro UWF para a sessão atual e a próxima sessão que se segue a uma reinicialização.

A segunda função, Add-RegistryExclusion, adiciona uma entrada do Registro à lista de exclusão do Registro UWF depois de reiniciar o dispositivo.

A terceira função, Remove-RegistryExclusion, remove uma entrada do Registro da lista de exclusão UWF depois de reiniciar o dispositivo.

A quarta função, Clear-RegistryExclusions, remove todas as exclusões de registro UWF. Você deve reiniciar o dispositivo antes que o UWF pare de filtrar as exclusões.

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

# Define common parameters

$CommonParams = @{"namespace"=$NAMESPACE; "computer"=$COMPUTER}

function Get-RegistryExclusions() {

# This function lists the UWF registry exclusions, both
# for the current session as well as the next session after a restart.


# Get the UWF_RegistryFilter configuration for the current session

    $currentConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $true
        };

# Get the UWF_RegistryFilter configuration for the next session after a restart

    $nextConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $false
        };

# Display registry exclusions for the current session

    if ($currentConfig) {

        Write-Host ""
        Write-Host "The following registry entries are currently excluded from UWF filtering:";

        $currentExcludedList = $currentConfig.GetExclusions()

        if ($currentExcludedList.ExcludedKeys) {
            foreach ($registryExclusion in $currentExcludedList.ExcludedKeys)  {
                Write-Host "  " $registryExclusion.RegistryKey
            }
        } else {
            Write-Host "  None"
        }
    } else {
        Write-Error "Could not retrieve UWF_RegistryFilter.";
}

# Display registry exclusions for the next session after a restart

    if ($nextConfig) {

        Write-Host ""
        Write-Host "The following registry entries will be excluded from UWF filtering after the next restart:";

        $nextExcludedList = $nextConfig.GetExclusions()

        if ($nextExcludedList.ExcludedKeys) {
            foreach ($registryExclusion in $nextExcludedList.ExcludedKeys)  {
                Write-Host "  " $registryExclusion.RegistryKey
            }
        } else {
            Write-Host "  None"
        }
        Write-Host ""
    }
}

function Add-RegistryExclusion($exclusion) {

# This function adds a new UWF registry exclusion.
# The new registry exclusion takes effect the next time the device is restarted and UWF is enabled.

# $exclusion is the path of the registry exclusion

# Get the UWF_RegistryFilter configuration for the next session after a restart

    $nextConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $false
        };

# Add the exclusion

    if ($nextConfig) {
        $nextConfig.AddExclusion($exclusion) | Out-Null;
        Write-Host "Added exclusion $exclusion.";
    } else {
        Write-Error "Could not retrieve UWF_RegistryFilter";
    }
}

function Remove-RegistryExclusion($exclusion) {

# This function removes a UWF registry exclusion.
# The registry exclusion is removed the next time the device is restarted

# $exclusion is the path of the registry exclusion

# Get the UWF_RegistryFilter configuration for the next session after a restart

    $nextConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $false
        };

# Try to remove the exclusion

    if ($nextConfig) {
        try {
            $nextConfig.RemoveExclusion($exclusion) | Out-Null;
            Write-Host "Removed exclusion $exclusion.";
        } catch {
            Write-Host "Could not remove exclusion $exclusion."
        }
    } else {
        Write-Error "Could not retrieve UWF_RegistryFilter";
    }
}

function Clear-RegistryExclusions() {

# This function removes all UWF registry exclusions
# The registry exclusions are removed the next time the device is restarted

# Get the configuration for the next session

    $nextConfig = Get-WMIObject -class UWF_RegistryFilter @CommonParams |
        where {
            $_.CurrentSession -eq $false
        };

# Remove all registry exclusions

    if ($nextConfig) {

        Write-Host "Removing all registry exclusions:";

        $nextExcludedList = $nextConfig.GetExclusions()

        if ($nextExcludedList) {
            foreach ($registryExclusion in $nextExcludedList.ExcludedKeys)  {
                Write-Host "Removing:" $registryExclusion.RegistryKey
                $nextConfig.RemoveExclusion($registryExclusion.RegistryKey) | Out-Null
            }
        } else {
            Write-Host "No registry exclusions to remove."
        }
        Write-Host ""
    }
}

# Some examples of using the functions

Clear-RegistryExclusions

Get-RegistryExclusions

Add-RegistryExclusion "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer"
Add-RegistryExclusion "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\DateTime\Servers\(Default)"

Get-RegistryExclusions

Remove-RegistryExclusion "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer"

Get-RegistryExclusions

Clear-RegistryExclusions

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

Filtro de Gravação Unificado

Partilhar via

UWF_RegistryFilter

Sintaxe

Membros

Propriedades

Comentários

Exemplo

Requisitos

Recursos adicionais

Partilhar via

UWF_RegistryFilter

Sintaxe

Membros

Propriedades

Comentários

Exemplo

Requisitos

Tópicos relacionados

Recursos adicionais