UWF_Filter

Abilita o disabilita un filtro di scrittura unificato (UWF), reimposta le impostazioni di configurazione per UWF e arresta o riavvia il dispositivo.

Sintassi

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

Membri

Nelle tabelle seguenti sono elencati i metodi e le proprietà che appartengono a questa classe.

Metodi

Proprietà

Osservazioni:

È necessario usare un account amministratore per apportare modifiche alle impostazioni di configurazione per UWF. Gli utenti con qualsiasi tipo di account possono leggere le impostazioni di configurazione correnti.

Esempio

Nell'esempio seguente viene illustrato come abilitare o disabilitare UWF usando il provider WMI in uno script di PowerShell.

Lo script di PowerShell crea tre funzioni per abilitare o disabilitare UWF. Viene quindi illustrato come usare ogni funzione.

La prima funzione, Disable-UWF, recupera un oggetto WMI per UWF_Filter e chiama il metodo Disable() per disabilitare UWF dopo il successivo riavvio del dispositivo.

La seconda funzione, Enable-UWF, recupera un oggetto WMI per UWF_Filter e chiama il metodo Enable() per abilitare UWF dopo il successivo riavvio del dispositivo.

La terza funzione, Display-UWFState, esamina le proprietà dell'oggetto UWF_Filter e stampa le impostazioni correnti per 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

Requisiti

Argomenti correlati

• Informazioni di riferimento sul provider WMI del filtro di scrittura unificato
• Filtro scrittura unificato