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	設定重疊的最大快取大小，以 MB 為單位。
UWF_OverlayConfig.SetType	將UWF重疊的類型設定為 RAM 型或磁碟型。

屬性

屬性	資料類型	限定詞	描述
CurrentSession	布林值	[key， read]	指出物件包含的設定的會話。 - True 是表示 如果下一個會話 - 在重新啟動後開始，則為 False。
類型	UInt32	[read]	表示重疊的類型。 - 0 表示磁碟重疊的 RAM 重疊- 1。
MaximumSize	SInt32	[read]	表示重疊的最大快取大小，以 MB 為單位。

備註

重疊設定的變更會在啟用UWF的下一次重新啟動時生效。

您必須先停用目前會話中的UWF，才能變更 Type 或 MaximumSize 屬性。

範例

下列範例示範如何在PowerShell腳本中使用Windows Management Instrumentation （WMI） 提供者，變更 UWF 中重疊的大小上限或儲存類型。

PowerShell 腳本會建立兩個函式來修改重迭組態。 接著會示範如何使用 函式。 第一個函式 Set-OverlaySize 會設定重疊的大小上限。 第二個函式 Set-OverlayType 會將重疊的類型設定為 RAM 型或磁碟型。

$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 Home	No
Windows 專業版	No
Windows 企業版	Yes
Windows 教育版	Yes
Windows IoT 企業版	Yes

相關主題

整合寫入篩選器 WMI 提供者參考資料

統一寫入篩選器