Partager via

UWF_Filter

Active ou désactive le filtre d’écriture unifié (UWF), réinitialise les paramètres de configuration pour UWF et arrête ou redémarre votre appareil.

Syntaxe

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

Membres

Les tableaux suivants répertorient toutes les méthodes et propriétés qui appartiennent à cette classe.

Méthodes

Méthodes Description
UWF_Filter.Enable Active UWF au prochain redémarrage.
UWF_Filter.Disable Désactive UWF au prochain redémarrage.
UWF_Filter.ResetSettings Restaure les paramètres UWF à l’état d’origine qui a été capturé au moment de l’installation.
UWF_Filter.ShutdownSystem Arrête en toute sécurité un système protégé par UWF, même si la superposition est pleine.
UWF_Filter.RestartSystem Redémarre en toute sécurité un système protégé par UWF, même si la superposition est pleine.

Propriétés

Propriété Type de données Qualificatifs Description
Id chaîne [key] ID unique. Cette valeur est toujours définie sur UWF_Filter
CurrentEnabled Booléen [read] Indique si UWF est activé pour la session active.
NextEnabled Booléen [read] Indique si UWF est activé après le redémarrage suivant.

Remarques

Vous devez utiliser un compte d’administrateur pour apporter des modifications aux paramètres de configuration pour UWF. Les utilisateurs disposant de n’importe quel type de compte peuvent lire les paramètres de configuration actuels.

Exemple

L’exemple suivant montre comment activer ou désactiver UWF à l’aide du fournisseur WMI dans un script PowerShell.

Le script PowerShell crée trois fonctions pour activer ou désactiver UWF. Il montre ensuite comment utiliser chaque fonction.

La première fonction, Disable-UWF, récupère un objet WMI pour UWF_Filter et appelle la méthode Disable() pour désactiver UWF après le redémarrage suivant de l’appareil.

La deuxième fonction, Enable-UWF, récupère un objet WMI pour UWF_Filter et appelle la méthode Enable() pour activer UWF après le redémarrage suivant de l’appareil.

La troisième fonction, Display-UWFState, examine les propriétés de l’objet UWF_Filter et imprime les paramètres actuels pour 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

Conditions préalables

Édition de Windows Pris en charge
Windows Famille Non
Windows Pro Non
Windows Entreprise Oui
Windows Éducation Oui
Windows IoT Entreprise Oui