Compartilhar via

UWF_OverlayConfig

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

Exibe e define configurações globais para a sobreposição do Filtro de Gravação Unificado (UWF). Você pode modificar o tamanho máximo e o tipo da sobreposição UWF.

Sintaxe

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

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

Membros

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

Métodos

Método Descrição
UWF_OverlayConfig.SetMaximumSize Define o tamanho máximo do cache, em megabytes, da sobreposição.
UWF_OverlayConfig.SetType Define o tipo de sobreposição UWF como baseado em RAM ou em disco.

Propriedades

Propriedade Tipo de dados Qualificadores Descrição
CurrentSession Booliano [chave, ler] Indica para qual sessão o objeto contém configurações.
- True para a sessão
- atual False para a próxima sessão que começa após uma reinicialização.
Tipo UInt32 [read] Indica o tipo de sobreposição.
- 0 para uma sobreposição
- baseada em RAM, 1 para uma sobreposição baseada em disco.
MaximumSize SInt32 [read] Indica o tamanho máximo do cache, em megabytes, da sobreposição.

Comentários

As alterações na configuração de sobreposição entram em vigor na próxima reinicialização em que o UWF está habilitado.

Antes de alterar as propriedades Type ou MaximumSize, o UWF deve ser desabilitado na sessão atual.

Exemplo

O exemplo a seguir demonstra como alterar o tamanho máximo ou o tipo de armazenamento da sobreposição no UWF usando o provedor WMI (Instrumentação de Gerenciamento do Windows) em um script do PowerShell.

O script do PowerShell cria duas funções para modificar a configuração de sobreposição. Em seguida, demonstra como usar as funções. A primeira função, Set-OverlaySize, define o tamanho máximo da sobreposição. A segunda função, Set-OverlayType, define o tipo da sobreposição como baseada em RAM ou em disco.

$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

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

Referência do provedor WMI de Filtro de Gravação Unificado

Filtro de Gravação Unificado