Поделиться через

UWF_OverlayConfig

  • Статья
  • Применяется к:
    ✅ Windows 11, ✅ Windows 10

Отображает и настраивает глобальные параметры для наложения единого фильтра записи (UWF). Можно изменить максимальный размер и тип наложения UWF.

Синтаксис

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

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

Участники

В следующих таблицах перечислены методы и свойства, принадлежащие этому классу.

Методы

Метод Description
UWF_OverlayConfig.SetMaximumSize Задает максимальный размер кэша в мегабайтах наложения.
UWF_OverlayConfig.SetType Задает тип наложения UWF на основе ОЗУ или на основе диска.

Свойства

Свойство Тип данных Квалификаторы Description
CurrentSession Логический [ключ, чтение] Указывает, для какого сеанса объект содержит параметры.
- Значение true для текущего сеанса False для следующего сеанса
- , начинающегося после перезапуска.
Тип UInt32 [чтение] Указывает тип наложения.
- 0 для наложения на основе ОЗУ 1 для наложения
- на диске.
MaximumSize SInt32 [чтение] Указывает максимальный размер кэша в мегабайтах наложения.

Замечания

Изменения конфигурации наложения вступают в силу при следующем перезапуске, в котором включенА UWF.

Прежде чем изменить свойства Type или MaximumSize , UWF необходимо отключить в текущем сеансе.

Пример

В следующем примере показано, как изменить максимальный размер или тип хранилища наложения в UWF с помощью поставщика инструментария управления Windows (WMI) в скрипте PowerShell.

Скрипт PowerShell создает две функции для изменения конфигурации наложения. Затем показано, как использовать функции. Первая функция Set-OverlaySize задает максимальный размер наложения. Вторая функция Set-OverlayType задает тип наложения на основе ОЗУ или на основе диска.

$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

Требования

Выпуск для Windows Поддерживается
Windows Домашняя No
Windows Pro No
Windows Корпоративная Да
Windows для образовательных учреждений Да
Windows IoT Корпоративная Да

Справочник по поставщику WMI для единого фильтра записи

Объединенный фильтр записи