UWF_OverlayConfig

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

Propriedades

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

Tópicos relacionados

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

Filtro de Gravação Unificado