Compartilhar via


UWF_Filter

Habilita ou desabilita o UWF (Filtro de Gravação Unificado), redefine as configurações da UWF e desliga ou reinicia o dispositivo.

Sintaxe

class UWF_Filter{
    [key]  string Id;
    [read] boolean CurrentEnabled;
    [read] boolean NextEnabled;
    UInt32 Enable();
    UInt32 Disable();
    UInt32 ResetSettings();
    UInt32 ShutdownSystem();
    UInt32 RestartSystem();
};

Membros

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

Métodos

Métodos Descrição
UWF_Filter.Enable Habilita a UWF na próxima reinicialização.
UWF_Filter.Disable Desabilita a UWF na próxima reinicialização.
UWF_Filter.ResetSettings Restaura as configurações de UWF para o estado original que foi capturado no momento da instalação.
UWF_Filter.ShutdownSystem Desliga com segurança um sistema protegido pela UWF, mesmo que a sobreposição esteja cheia.
UWF_Filter.RestartSystem Reinicia com segurança um sistema protegido pela UWF, mesmo que a sobreposição esteja cheia.

Propriedades

Propriedade Tipo de dados Qualificadores Descrição
Id string [key] Uma ID exclusiva. Isso está sempre definido para UWF_Filter
CurrentEnabled Boolean [read] Indica se a UWF está habilitada para a sessão atual.
NextEnabled Boolean [read] Indica se a UWF está habilitada após a próxima reinicialização.

Comentários

Use uma conta de administrador para fazer alterações nas configurações da UWF. Os usuários com qualquer tipo de conta podem ler as configurações atuais.

Exemplo

O exemplo a seguir demonstra como habilitar ou desabilitar a UWF usando o provedor WMI em um script do PowerShell.

O script do PowerShell cria três funções para ajudar a habilitar ou desabilitar a UWF. Em seguida, ele demonstra como usar cada função.

A primeira função, Disable-UWF, recupera um objeto WMI para UWF_Filter e chama o método Disable() para desabilitar a UWF após a próxima reinicialização do dispositivo.

A segunda função, Enable-UWF, recupera um objeto WMI para UWF_Filter e chama o método Enable() para habilitar a UWF após a próxima reinicialização do dispositivo.

A terceira função, Display-UWFState, examina as propriedades do objeto UWF_Filter e imprime as configurações atuais para UWF_Filter.

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

# Create a function to disable the Unified Write Filter driver after the next restart.
function Disable-UWF() {

# Retrieve the UWF_Filter settings.
    $objUWFInstance = Get-WMIObject -namespace $NAMESPACE -class UWF_Filter;

    if(!$objUWFInstance) {
        "Unable to retrieve Unified Write Filter settings."
        return;
    }

# Call the method to disable UWF after the next restart.  This sets the NextEnabled property to false.

    $retval = $objUWFInstance.Disable();

# Check the return value to verify that the disable is successful
    if ($retval.ReturnValue -eq 0) {
        "Unified Write Filter will be disabled after the next system restart."
    } else {
        "Unknown Error: " + "{0:x0}" -f $retval.ReturnValue
    }
}

# Create a function to enable the Unified Write Filter driver after the next restart.
function Enable-UWF() {

# Retrieve the UWF_Filter settings.
    $objUWFInstance = Get-WMIObject -namespace $NAMESPACE -class UWF_Filter;

    if(!$objUWFInstance) {
        "Unable to retrieve Unified Write Filter settings."
    return;
    }

# Call the method to enable UWF after the next restart.  This sets the NextEnabled property to false.

    $retval = $objUWFInstance.Enable();

# Check the return value to verify that the enable is successful
    if ($retval.ReturnValue -eq 0) {
        "Unified Write Filter will be enabled after the next system restart."
    } else {
        "Unknown Error: " + "{0:x0}" -f $retval.ReturnValue
    }
}

# Create a function to display the current settings of the Unified Write Filter driver.
function Display-UWFState() {

# Retrieve the UWF_Filter object
    $objUWFInstance = Get-WmiObject -Namespace $NAMESPACE -Class UWF_Filter;

    if(!$objUWFInstance) {
        "Unable to retrieve Unified Write Filter settings."
        return;
    }

# Check the CurrentEnabled property to see if UWF is enabled in the current session.
    if($objUWFInstance.CurrentEnabled) {
        $CurrentStatus = "enabled";
    } else {
        $CurrentStatus = "disabled";
    }

# Check the NextEnabled property to see if UWF is enabled or disabled after the next system restart.
    if($objUWFInstance.NextEnabled) {
        $NextStatus = "enabled";
    } else {
        $NextStatus = "disabled";
    }
}

# Some examples of how to call the functions

Display-UWFState

"Enabling Unified Write Filter"
Enable-UWF

Display-UWFState

"Disabling Unified Write Filter"
Disable-UWF

Display-UWFState

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