UWF_OverlayConfig

  • Статья

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

Синтаксис

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

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

Члены

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

Методы

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

Свойства

Свойство Тип данных Квалификаторы Описание
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 Нет
Windows Pro Нет
Windows Корпоративная Да
Windows для образовательных учреждений Да
Windows IoT Корпоративная Да

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

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