UWF_Filter

Habilita ou desabilita o UWF (Filtro de Gravação Unificado), redefine as definições de configuração do 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

Propriedades

Comentários

Você deve usar uma conta de administrador para fazer alterações nas definições de configuração da UWF. Usuários com qualquer tipo de conta podem ler as definições de configuração 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 o 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 o 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

Artigos relacionados

• Filtro de Gravação Unificado Referência de provedor WMI
• Filtro de Gravação Unificado