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 | 布林值 | [索引鍵，讀取] | 指出物件包含設定的會話。
- 如果目前的會話 - 為 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 首頁 | 否 |
| Windows 專業版 | 否 |
| Windows 企業版 | 是 |
| Windows 教育版 | 是 |
| Windows IoT 企業版 | 是 |