Compartilhar via

UWF_Overlay

  • Artigo
  • Aplica-se a:
    ✅ Windows 11, ✅ Windows 10

Contém o tamanho atual da sobreposição do Filtro de Gravação Unificado (UWF) e gerencia os limites críticos e de aviso para o tamanho da sobreposição.

Sintaxe

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
    );
};

Membros

As tabelas a seguir listam todos os métodos e propriedades que pertencem a essa classe.

Métodos Descrição
UWF_Overlay.GetOverlayFiles Retorna uma lista de arquivos de um volume que foram armazenados em cache na sobreposição UWF.
UWF_Overlay.SetWarningThreshold Define o limite de aviso para monitorar o tamanho da sobreposição UWF.
UWF_Overlay.SetCriticalThreshold Define o limite de aviso crítico para monitorar o tamanho da sobreposição UWF.

Propriedades

Propriedade Tipo de dados Qualificadores Descrição
ID string [key] Uma ID exclusiva. Isso está sempre definido para UWF_Overlay.
OverlayConsumption Uint32 [read] O tamanho atual, em megabytes, da sobreposição UWF.
Espaço Disponível: Uint32 [read] A quantidade de espaço livre, em megabytes, disponível para a sobreposição UWF.
CriticalOverlayThreshold Uint32 [read] O tamanho do limite crítico, em megabytes. O UWF envia um evento de notificação de limite crítico quando o tamanho de sobreposição do UWF atinge ou excede esse valor.
WarningOverlayThreshold Uint32 [read] O tamanho do limite de aviso, em megabytes. O UWF envia um evento de notificação de limite de aviso quando o tamanho de sobreposição do UWF atinge ou excede esse valor.

Exemplos

O exemplo a seguir demonstra como usar a sobreposição UWF usando o provedor WMI em um script do PowerShell.

$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

Comentários

Apenas uma instância UFW_Overlay existe para um sistema protegido com UWF.

Requisitos

Edição do Windows Com suporte
Windows Home Não
Windows Pro Não
Windows Enterprise Sim
Educação do Windows Sim
Windows IoT Enterprise Yes