UWF_Filter

  • Artículo

Habilita o deshabilita el filtro de escritura unificado (UWF), restablece las opciones de configuración de UWF y apaga o reinicia el dispositivo.

Sintaxis

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

Miembros

En las tablas siguientes se enumeran todos los métodos y propiedades que pertenecen a esta clase.

Métodos

Métodos Descripción
UWF_Filter.Enable Habilita UWF en el siguiente reinicio.
UWF_Filter.Disable Deshabilita UWF en el siguiente reinicio.
UWF_Filter.ResetSettings Restaura la configuración de UWF en el estado inal orig que se capturó en el momento de la instalación.
UWF_Filter.ShutdownSystem Apaga de forma segura un sistema protegido por UWF, incluso si la superposición está completa.
UWF_Filter.RestartSystem Reinicia de forma segura un sistema protegido por UWF, incluso si la superposición está completa.

Propiedades

Propiedad Tipo de datos Calificadores Descripción
Id string [key] Identificador único. Siempre se establece en UWF_Filter
CurrentEnabled Boolean [read] Indica si UWF está habilitado para la sesión actual.
NextEnabled Boolean [read] Indica si UWF está habilitado después del siguiente reinicio.

Comentarios

Debe usar una cuenta de administrador para realizar cambios en las opciones de configuración de UWF. Los usuarios con cualquier tipo de cuenta pueden leer las opciones de configuración actuales.

Ejemplo

En el ejemplo siguiente se muestra cómo habilitar o deshabilitar UWF mediante el proveedor WMI en un script de PowerShell.

El script de PowerShell crea tres funciones para ayudar a habilitar o deshabilitar UWF. A continuación, se muestra cómo usar cada función.

La primera función, Disable-UWF, recupera un objeto WMI para UWF_Filter y llama al método Disable() para deshabilitar UWF después del siguiente reinicio del dispositivo.

La segunda función, Enable-UWF, recupera un objeto WMI para UWF_Filter y llama al método Enable() para habilitar UWF después del siguiente reinicio del dispositivo.

La tercera función, Display-UWFState, examina las propiedades del objeto UWF_Filter e imprime la configuración actual 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

Edición de Windows Compatible
Windows Home No
Windows Pro No
Windows Enterprise Sí
Windows Education Sí
Windows IoT Enterprise Sí