Partager via

UWF_OverlayConfig

  • Article
  • S’applique à:
    ✅ Windows 11, ✅ Windows 10

Affiche et configure les paramètres globaux pour la superposition de filtre d’écriture unifié (UWF). Vous pouvez modifier la taille maximale et le type de superposition UWF.

Syntaxe

class UWF_OverlayConfig{
    [key, Read] boolean CurrentSession;
    [read] UInt32 Type;
    [read] SInt32 MaximumSize;

    UInt32 SetType(
        UInt32 type
    );
    UInt32 SetMaximumSize(
        UInt32 size
    );
};

Membres

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

Méthodes

méthode Description
UWF_OverlayConfig.SetMaximumSize Définit la taille maximale du cache, en mégaoctets, de la superposition.
UWF_OverlayConfig.SetType Définit le type de superposition UWF sur ram ou sur disque.

Propriétés

Propriété Type de données Qualificateurs Description
CurrentSession Boolean [clé, lecture] Indique la session pour laquelle l’objet contient les paramètres.
- True pour la session
- active False pour la session suivante qui commence après un redémarrage.
Type UInt32 [Lecture] Indique le type de superposition.
- 0 pour une superposition
- basée sur la RAM 1 pour une superposition sur disque.
MaximumSize SInt32 [Lecture] Indique la taille maximale du cache, en mégaoctets, de la superposition.

Notes

Les modifications apportées à la configuration de superposition prennent effet sur le redémarrage suivant dans lequel UWF est activé.

Avant de pouvoir modifier les propriétés Type ou MaximumSize , UWF doit être désactivé dans la session active.

Exemple

L’exemple suivant montre comment modifier la taille maximale ou le type de stockage de la superposition dans UWF à l’aide du fournisseur WMI (Windows Management Instrumentation) dans un script PowerShell.

Le script PowerShell crée deux fonctions pour modifier la configuration de superposition. Il montre ensuite comment utiliser les fonctions. La première fonction, Set-OverlaySize, définit la taille maximale de la superposition. La deuxième fonction, Set-OverlayType, définit le type de la superposition sur ram ou sur disque.

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

# Define common parameters

$CommonParams = @{"namespace"=$NAMESPACE; "computer"=$COMPUTER}

function Set-OverlaySize([UInt32] $size) {

# This function sets the size of the overlay to which file and registry changes are redirected
# Changes take effect after the next restart

# $size is the maximum size in MB of the overlay

# Make sure that UWF is currently disabled

    $UWFFilter = Get-WmiObject -class UWF_Filter @commonParams

    if ($UWFFilter.CurrentEnabled -eq $false) {

# Get the configuration for the next session after a restart

        $nextConfig = Get-WMIObject -class UWF_OverlayConfig -Filter "CurrentSession = false" @CommonParams;

        if ($nextConfig) {

# Set the maximum size of the overlay

        $nextConfig.SetMaximumSize($size);
            write-host "Set overlay max size to $size MB."
        }
    } else {
        write-host "UWF must be disabled in the current session before you can change the overlay size."
    }
}

function Set-OverlayType([UInt32] $overlayType) {

# This function sets the type of the overlay to which file and registry changes are redirected
# Changes take effect after the next restart

# $overlayType is the type of storage that UWF uses to maintain the overlay. 0 = RAM-based; 1 = disk-based.

    $overlayTypeText = @("RAM-based", "disk-based")

# Make sure that the overlay type is a valid value

    if ($overlayType -eq 0 -or $overlayType -eq 1) {

# Make sure that UWF is currently disabled

        $UWFFilter = Get-WmiObject -class UWF_Filter @commonParams

        if ($UWFFilter.CurrentEnabled -eq $false) {

# Get the configuration for the next session after a restart

            $nextConfig = Get-WMIObject -class UWF_OverlayConfig -Filter "CurrentSession = false" @CommonParams;

            if ($nextConfig) {

# Set the type of the overlay

        $nextConfig.SetType($overlayType);
                write-host "Set overlay type to $overlayTypeText[$overlayType]."
            }
        } else {
            write-host "UWF must be disabled in the current session before you can change the overlay type."
        }
    } else {
        write-host "Invalid value for overlay type.  Valid values are 0 (RAM-based) or 1 (disk-based)."
    }
}

# The following sample commands demonstrate how to use the functions to change the overlay configuration

$RAMMode = 0
$DiskMode = 1

Set-OverlaySize 2048

Set-OverlayType $DiskMode

Spécifications

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

Informations de référence sur le fournisseur WMI du filtre d’écriture unifié

Filtre d’écriture unifié