UWF_Overlay

Enthält die aktuelle Größe des Unified Write Filter (UWF)-Overlays und verwaltet die kritischen und Warnschwellenwerte für die Überlagerungsgröße.

Syntax

class UWF_Overlay {
    [key]  string Id;
    [read] UInt32 OverlayConsumption;
    [read] UInt32 AvailableSpace;
    [read] UInt32 CriticalOverlayThreshold;
    [read] UInt32 WarningOverlayThreshold;

    UInt32 GetOverlayFiles(
        [in] string Volume,
        [out, EmbeddedInstance("UWF_OverlayFile")] string OverlayFiles[]
    );
    UInt32 SetWarningThreshold(
        UInt32 size
    );
    UInt32 SetCriticalThreshold(
        UInt32 size
    );
};

Member

In den folgenden Tabellen sind alle Methoden und Eigenschaften aufgeführt, die zu dieser Klasse gehören.

Methoden

Methoden	BESCHREIBUNG
UWF_Overlay.GetOverlayFiles	Gibt eine Liste der Dateien eines Volumes zurück, das im UWF-Overlay zwischengespeichert wurde.
UWF_Overlay.SetWarningThreshold	Legt den Warnungsschwellenwert fest, um die Größe der UWF-Überlagerung zu überwachen.
UWF_Overlay.SetCriticalThreshold	Legt den kritischen Warnungsschwellenwert fest, um die Größe der UWF-Überlagerung zu überwachen.

Eigenschaften

Eigenschaft	Datentyp	Qualifizierer	BESCHREIBUNG
Id	Zeichenfolge	[Taste]	Eine eindeutige ID. Dies ist immer auf UWF_Overlay festgelegt.
OverlayConsumption	UInt32	[lesen]	Die aktuelle Größe in Megabyte des UWF-Overlays.
AvailableSpace	UInt32	[lesen]	Die Menge des freien Speicherplatzes in Megabyte, der für die UWF-Überlagerung verfügbar ist.
CriticalOverlayThreshold	UInt32	[lesen]	Die kritische Schwellenwertgröße in Megabyte. UWF sendet ein kritisches Schwellenwertbenachrichtigungsereignis, wenn die Größe der UWF-Überlagerung diesen Wert erreicht oder überschreitet.
WarningOverlayThreshold	UInt32	[lesen]	Die Warnungsschwellengröße in Megabyte. UWF sendet ein Warnungsschwellenbenachrichtigungsereignis, wenn die Größe der UWF-Überlagerung diesen Wert erreicht oder überschreitet.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die UWF-Überlagerung mithilfe des WMI-Anbieters in einem PowerShell-Skript verwenden.

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

# Function to set the Unified Write Filter overlay warning threshold

function Set-OverlayWarningThreshold($ThresholdSize) {

# Retrieve the overlay WMI object

    $OverlayInstance = Get-WMIObject -namespace $NAMESPACE -class UWF_Overlay;

    if(!$OverlayInstance) {
        "Unable to get handle to an instance of the UWF_Overlay class"
        return;
    }

# Call the instance method to set the warning threshold value

    $retval = $OverlayInstance.SetWarningThreshold($ThresholdSize);

# Check the return value to verify that setting the warning threshold is successful

    if ($retval.ReturnValue -eq 0) {
        "Overlay warning threshold has been set to " + $ThresholdSize + " MB"
    } else {
        "Unknown Error: " + "{0:x0}" -f $retval.ReturnValue
    }
}

# Function to set the Unified Write Filter overlay critical threshold

function Set-OverlayCriticalThreshold($ThresholdSize) {

# Retrieve the overlay WMI object

    $OverlayInstance = Get-WMIObject -namespace $NAMESPACE -class UWF_Overlay;

    if(!$OverlayInstance) {
        "Unable to get handle to an instance of the UWF_Overlay class"
        return;
    }

# Call the instance method to set the warning threshold value

    $retval = $OverlayInstance.SetCriticalThreshold($ThresholdSize);

# Check the return value to verify that setting the critical threshold is successful

    if ($retval.ReturnValue -eq 0) {
        "Overlay critical threshold has been set to " + $ThresholdSize + " MB"
    } else {
        "Unknown Error: " + "{0:x0}" -f $retval.ReturnValue
    }
}

# Function to print the current overlay information

function Get-OverlayInformation() {

# Retrieve the Overlay WMI object

    $OverlayInstance = Get-WMIObject -namespace $NAMESPACE -class UWF_Overlay;

    if(!$OverlayInstance) {
        "Unable to get handle to an instance of the UWF_Overlay class"
        return;
    }

# Display the current values of the overlay properties

    "`nOverlay Consumption: " + $OverlayInstance.OverlayConsumption
    "Available Space: " + $OverlayInstance.AvailableSpace
    "Critical Overlay Threshold: " + $OverlayInstance.CriticalOverlayThreshold
    "Warning Overlay Threshold: " + $OverlayInstance.WarningOverlayThreshold
}

# Examples of using these functions

"`nSetting the warning threshold to 768 MB."
Set-OverlayWarningThreshold( 768 )

"`nSetting the critical threshold to 896 MB."
Set-OverlayCriticalThreshold( 896 )

"`nDisplaying the current state of the overlay."
Get-OverlayInformation

Hinweise

Es gibt nur eine UFW_Overlay Instanz für ein System, das mit UWF geschützt ist.

Anforderungen

Windows-Edition	Unterstützt
Windows 10 Home	Nein
Windows 10 Pro	Nein
Windows 10 Enterprise	Yes
Windows 10 Education	Yes

Verwandte Themen

Einheitlicher Schreibfilter