KB5035679：运行脚本以重设恢复分区大小以安装 WinRE 更新的说明

摘要

本文介绍如何使用Microsoft提供的示例脚本来增加恢复分区的大小，以启用 Windows 恢复环境 (WinRE) 服务。 WinRE 是一种工具，可帮助你排查各种系统问题并从中恢复，例如启动失败、恶意软件感染或系统文件损坏。

WinRE 需要恢复分区上的足够可用空间才能成功安装 WinRE 更新。但是，某些设备可能具有小型恢复分区，这些分区没有足够的空间。示例脚本可以帮助你调整设备恢复分区的大小，以避免潜在的 WinRE 服务失败。

如何使用此脚本将 WinRE 分区大小增加 250 MB

################################################################################################

#

# Copyright (c) Microsoft Corporation.

# Licensed under the MIT License.

#

# THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

# SOFTWARE.

#

################################################################################################

Param (
[Parameter(Mandatory=$false,HelpMessage="Skip confirmation")][bool]$SkipConfirmation=$false,
[Parameter(Mandatory=$true,HelpMessage="Path to backup old WinRE partition content to")][string]$BackupFolder
)

# ------------------------------------
# Helper functions
# ------------------------------------

# Log message
function LogMessage([string]$message)
{
    $message = "$message"
    Write-Host $message
}

# Extract numbers from string
function ExtractNumbers([string]$str)
{
    $cleanString = $str -replace "[^0-9]"
    return [long]$cleanString
}

# Display partition info using fsutil
# Return an array, the first value is total size and the second value is free space
function DisplayPartitionInfo([string[]]$partitionPath)
{
    $volume = Get-WmiObject -Class Win32_Volume | Where-Object { $partitionPath -contains $_.DeviceID }
    LogMessage("  Partition capacity: " +  $volume.Capacity)
    LogMessage("  Partition free space: " + $volume.FreeSpace)
    return $volume.Capacity, $volume.FreeSpace
} 

# Display WinRE status
function DisplayWinREStatus()
{
    # Get WinRE partition info
    $WinREInfo = Reagentc /info
    foreach ($line in $WinREInfo)
    {
        $params = $line.Split(':')
        if ($params.Count -lt 2)
        {
            continue
        }
        if (($params[1].Trim() -ieq "Enabled") -Or (($params[1].Trim() -ieq "Disabled")))
        {
            $Status = $params[1].Trim() -ieq "Enabled"
            LogMessage($line.Trim())
        }
        if ($params[1].Trim() -like "\\?\GLOBALROOT*")
        {
            $Location = $params[1].Trim()
            LogMessage($line.Trim())
        }
    }
    
    return $Status, $Location
}

# ------------------------------------
# Main execution
# ------------------------------------

# Clear the error
$Error.Clear()

# ------------------------------------
# Examining the system to collect required info 
# for the execution
# Need to check WinRE status, collect OS and WinRE
# partition info
# ------------------------------------
LogMessage("Start time: $([DateTime]::Now)")

LogMessage("Examining the system...")
$NeedShrink = $true
$NeedCreateNew = $false
$NeedBackup = $false

# Get WinRE partition info
$InitialWinREStatus = DisplayWinREStatus
$WinREStatus = $InitialWinREStatus[0]
$WinRELocation = $InitialWinREStatus[1]

if (!$WinREStatus)
{
    LogMessage("Error: WinRE Disabled")
    exit 1
}

# Get System directory and ReAgent xml file
$system32Path = [System.Environment]::SystemDirectory
LogMessage("System directory: " + $system32Path)
$ReAgentXmlPath = Join-Path -Path $system32Path -ChildPath "\Recovery\ReAgent.xml"
LogMessage("ReAgent xml: " + $ReAgentXmlPath)
if (!(Test-Path  $ReAgentXmlPath))
{
    LogMessage("Error: ReAgent.xml cannot be found")
    exit 1
}

# Get OS partition
LogMessage("")
LogMessage("Collecting OS and WinRE partition info...")
$OSDrive = $system32Path.Substring(0,1)
$OSPartition = Get-Partition -DriveLetter $OSDrive

# Get WinRE partition
$WinRELocationItems = $WinRELocation.Split('\\')
foreach ($item in $WinRELocationItems)
{
    if ($item -like "harddisk*")
    {
        $OSDiskIndex = ExtractNumbers($item)
    }
    if ($item -like "partition*")
    {
        $WinREPartitionIndex = ExtractNumbers($item)
    }
}

LogMessage("OS Disk: " + $OSDiskIndex)
LogMessage("OS Partition: " + $OSPartition.PartitionNumber)
LogMessage("WinRE Partition: " + $WinREPartitionIndex)

$WinREPartition = Get-Partition -DiskNumber $OSDiskIndex -PartitionNumber $WinREPartitionIndex

$diskInfo = Get-Disk -number $OSDiskIndex
$diskType = $diskInfo.PartitionStyle
LogMessage("Disk PartitionStyle: " + $diskType)

# Display WinRE partition size info
LogMessage("WinRE partition size info")
$WinREPartitionSizeInfo = DisplayPartitionInfo($WinREPartition.AccessPaths)
LogMessage("WinRE Partition Offset: " + $WinREPartition.Offset)
LogMessage("WinRE Partition Type: " + $WinREPartition.Type)
LogMessage("OS partition size: " + $OSPartition.Size)
LogMessage("OS partition Offset: " + $OSPartition.Offset)
$OSPartitionEnds = $OSPartition.Offset + $OSPartition.Size

LogMessage("OS partition ends at: " + $OSPartitionEnds)
LogMessage("WinRE partition starts at: " + $WinREPartition.Offset)

$WinREIsOnSystemPartition = $false
if ($diskType -ieq "MBR")
{
    if ($WinREPartition.IsActive)
    {
        LogMessage("WinRE is on System partition")
        $WinREIsOnSystemPartition = $true
    }
}

if ($diskType -ieq "GPT")
{
    if ($WinREPartition.Type -ieq "System")
    {
        LogMessage("WinRE is on System partition")
        $WinREIsOnSystemPartition = $true
    }
}

# Checking the BackupFolder parameter
if ($PSBoundParameters.ContainsKey('BackupFolder'))
{
    LogMessage("")
    LogMessage("Backup Directory: [" + $BackupFolder + "]")
    
    $Needbackup = $true
    
    if ($WinREIsOnSystemPartition)
    {
        $Needbackup = $false
        LogMessage("WinRE is on System partition which will be preserved. No need to backup content")
    }
    else
    {
        if (Test-path $BackupFolder)
        {
            $items = Get-ChildItem -Path $BackupFolder

            if ($items)
            {
                LogMessage("Error: Existing backup directory is not empty")
                exit 1
            }
        }
        else
        {
            LogMessage("Creating backup directory...")
            try 
            {
                $item = New-Item -Path $BackupFolder -ItemType Directory -ErrorAction Stop

                if ($item)
                {
                    LogMessage("Backup directory created")
                }
                else
                {
                    LogMessage("Error: Failed to create backup directory [" + $BackupFolder + "]")
                    exit 1
                }
            } catch 
            {
                LogMessage("Error: An error occurred: $_")
                exit 1
            }
        }
    }
}

# ------------------------------------
# Verify whether we meet requirements of execution
# - WinRE cannot be on OS partition for the extension
# - WinRE partition must be the next partition after OS partition
# - If WinRE partition already have >=250MB free space, no need to do repartition
# - If there is enough unallocated space to grow the WinRE partition size, skip shrinking OS
# 
# However, if the WinRE partition is before the OS partition, there is no chance to extend it
# As a result, it's better to create a new WinRE partition after the OS partition
# ------------------------------------

# Perform a few checks
LogMessage("")
LogMessage("Verifying if the WinRE partition needs to be extended or not...")

if (!(($diskType -ieq "MBR") -Or ($diskType -ieq "GPT")))
{
    LogMessage("Error: Got an unexpected disk partition style: " +$diskType)
    exit 1
}

# WinRE partition must be after OS partition for the repartition
if ($WinREPartitionIndex -eq $OSPartition.PartitionNumber)
{
    LogMessage("WinRE and OS are on the same partition, should not perform extension")
    exit 0
}

$supportedSize = Get-PartitionSupportedSize -DriveLetter $OSDrive

# if there is enough free space, skip extension
if ($WinREPartitionSizeInfo[1] -ge 250MB)
{
    LogMessage("More than 250 MB of free space was detected in the WinRE partition, there is no need to extend the partition")
    exit 0
}

if ($WinREPartition.Offset -lt $OSPartitionEnds)
{
    LogMessage("WinRE partition is not after OS partition, cannot perform extension")
    LogMessage("Need to create a new WinRE partition after OS partition")
    $NeedCreateNew = $true
    $NeedShrink = $true
    
    # Calculate the size of repartition
    # Will create a new WinRE partition with current WinRE partition size + 250 MB
    # The OS partition size will be shrunk by the new WinRE partition size
    $targetWinREPartitionSize = $WinREPartitionSizeInfo[0] + 250MB
    $shrinkSize = [Math]::Ceiling($targetWinREPartitionSize / 1MB) * 1MB
    $targetOSPartitionSize = $OSPartition.Size - $shrinkSize
    if ($targetOSPartitionSize -lt $supportedSize.SizeMin)
    {
        LogMessage("Error: The target OS partition size after shrinking is smaller than the supported minimum size, cannot perform the repartition")
        exit 1
    }
}
else
{
    if ($WinREIsOnSystemPartition)
    {
        LogMessage("WinRE parititon is after the OS partition and it's also System partition")
        LogMessage("Error: Got unexpected disk layout, cannot proceed")
        exit 1
    }
    if (!($WinREPartitionIndex -eq ($OSPartition.PartitionNumber + 1)))
    {
        LogMessage("Error: WinRE partition is not right after the OS partition, cannot extend WinRE partition")
        exit 1
    }

    # Calculate the size of repartition
    # Will shrink OS partitition by 250 MB
    $shrinkSize = 250MB
    $targetOSPartitionSize = $OSPartition.Size - $shrinkSize
    $targetWinREPartitionSize = $WinREPartitionSizeInfo[0] + 250MB

    $UnallocatedSpace = $WinREPartition.Offset - $OSPartitionEnds;

    # If there is unallocated space, consider using it
    if ($UnallocatedSpace -ge 250MB)
    {
        $UnallocatedSpace = $WinREPartition.Offset - $OSPartitionEnds;
        LogMessage("Found unallocated space between OS and WinRE partition: " + $UnallocatedSpace)
        LogMessage("There is already enough space to extend WinRE partition without shrinking the OS partition")
        $NeedShrink = $false
        $targetOSPartitionSize = 0
    }
    else
    {
        $shrinkSize = [Math]::Ceiling((250MB - $UnallocatedSpace)/ 1MB) * 1MB
        if ($shrinkSize > 250MB)
        {
            $shrinkSize = 250MB
        }
        $targetOSPartitionSize = $OSPartition.Size - $shrinkSize
        if ($targetOSPartitionSize -lt $supportedSize.SizeMin)
        {
            LogMessage("Error: The target OS partition size after shrinking is smaller than the supported minimum size, cannot perform the repartition")
            exit 1
        }
    }
}

# ------------------------------------
# Report execution plan and ask for user confirmation to continue
# ------------------------------------

# Report the changes planned to be executed, waiting for user confirmation
LogMessage("")
LogMessage("Summary of proposed changes")
if ($NeedCreateNew)
{
    LogMessage("Note: WinRE partition is before OS partition, need to create a new WinRE partition after OS partition")
    LogMessage("Will shrink OS partition by " + $shrinkSize)
    LogMessage("  Current OS partition size: " + $OSPartition.Size)
    LogMessage("  Target OS partition size after shrinking: " + $targetOSPartitionSize)
    LogMessage("New WinRE partition will be created with size: ", $targetWinREPartitionSize)
    if ($WinREIsOnSystemPartition)
    {
        LogMessage("Existing WinRE partition is also system partition, it will be preserved")
    }
    else
    {
        LogMessage("Existing WinRE partition will be deleted")
        LogMessage("  WinRE partition: Disk [" + $OSDiskIndex + "] Partition [" + $WinREPartitionIndex + "]")
        LogMessage("  Current WinRE partition size: " + $WinREPartitionSizeInfo[0])
    }
}
else
{
    if ($NeedShrink)
    {
        LogMessage("Will shrink OS partition by " + $shrinkSize)
        LogMessage("  Current OS partition size: " + $OSPartition.Size)
        LogMessage("  Target OS partition size after shrinking: " + $targetOSPartitionSize)
        if ($UnallocatedSpace -ge 0)
        {
            LogMessage("Unallocated space between OS and WinRE partition that will be used towards the new WinRE partition: " + $UnallocatedSpace)
        }
    }
    else
    {
        LogMessage("Will use 250MB from unallocated space between OS and WinRE partition")
    }

    LogMessage("Will extend WinRE partition size by 250MB")
    LogMessage("  WinRE partition: Disk [" + $OSDiskIndex + "] Partition [" + $WinREPartitionIndex + "]")
    LogMessage("  Current WinRE partition size: " + $WinREPartitionSizeInfo[0])
    LogMessage("  New WinRE partition size:     " + $targetWinREPartitionSize)
    LogMessage("WinRE will be temporarily disabled before extending the WinRE partition and enabled automatically in the end")

    if ($UnallocatedSpace -ge 100MB)
    {
        LogMessage("Warning: More than 100MB of unallocated space was detected between the OS and WinRE partitions")
        LogMessage("Would you like to proceed by using the unallocated space between the OS and the WinRE partitions?")
    }
}

if ($Needbackup)
{
    LogMessage("")
    LogMessage("The contents of the old WinRE partition will be backed up to [" + $BackupFolder + "]")
}

LogMessage("")
LogMessage("Please reboot the device before running this script to ensure any pending partition actions are finalized")

LogMessage("")
if ($SkipConfirmation)
{
    LogMessage("User chose to skip confirmation")
    LogMessage("Proceeding with changes...")
}
else
{
    $userInput = Read-Host -Prompt "Would you like to proceed? Y for Yes and N for No"
        
    if ($userInput -ieq "Y")
    {
        LogMessage("Proceeding with changes...")
    }
    elseif ($userInput -ieq "N")
    {
        LogMessage("Canceling based on user request, no changes were made to the system")
        exit 0
    }
    else
    {
        LogMessage("Error: Unexpected user input: [" + $userInput + "]") 
        exit 0
    }
}

LogMessage("")
LogMessage("Note: To prevent unexpected results, please do not interrupt the execution or restart your system")

# ------------------------------------
# Do the actual execution
# The main flow is:
# 1. Check whether ReAgent.xml has stage location and clear it for repartiion
# 2. Disable WinRE as WinRE partition will be deleted
# 3. Perform the repartition to create a larger WinRE partition
# 4. Re-enable WinRE
# ------------------------------------

LogMessage("")

# Load ReAgent.xml to clear Stage location
LogMessage("Loading [" + $ReAgentXmlPath + "] ...")
$xml = [xml](Get-Content -Path $ReAgentXmlPath)
$node = $xml.WindowsRE.ImageLocation
if (($node.path -eq "") -And ($node.guid -eq "{00000000-0000-0000-0000-000000000000}") -And ($node.offset -eq "0") -And ($node.id -eq "0"))
{
    LogMessage("Stage location info is empty")
}
else
{
    LogMessage("Clearing stage location info...")
    $node.path = ""
    $node.offset = "0"
    $node.guid= "{00000000-0000-0000-0000-000000000000}"
    $node.id="0"

    # Save the change
    LogMessage("Saving changes to [" + $ReAgentXmlPath + "]...")
    $xml.Save($ReAgentXmlPath)
}

# Disable WinRE
LogMessage("Disabling WinRE...")
reagentc /disable
if (!($LASTEXITCODE -eq 0))
{
    LogMessage("Warning: encountered an error when disabling WinRE: " + $LASTEXITCODE)
    exit $LASTEXITCODE
}

# Verify WinRE is under C:\Windows\System32\Recovery\WinRE.wim
$disableWinREPath = Join-Path -Path $system32Path -ChildPath "\Recovery\WinRE.wim"
LogMessage("Verifying that WinRE wim exists in downlevel at default location")
if (!(Test-Path $disableWinREPath))
{
    LogMessage("Error: Cannot find " + $disableWinREPath)
    
    # Re-enable WinRE
    LogMessage("Re-enabling WinRE on error...")
    reagentc /enable
    if (!($LASTEXITCODE -eq 0))
    {
        LogMessage("Warning: encountered an error when enabling WinRE: " + $LASTEXITCODE)
    }
    exit 1
}

# ------------------------------------
# Perform the repartition
# 1. Resize the OS partition
# 2. Delete the WinRE partition
# 3. Create a new WinRE partition
# ------------------------------------
LogMessage("Performing repartition to extend the WinRE partition ...")

# 1. Resize the OS partition
if ($NeedShrink)
{
    LogMessage("Shrinking the OS partition to create a larger WinRE partition")
    LogMessage("Resizing the OS partition to: [" + $targetOSPartitionSize + "]...")
    Resize-Partition -DriveLetter $OSDrive -Size $targetOSPartitionSize
    if ($Error.Count -gt 0) {
        LogMessage("Error: Resize-Partition encountered errors: " + $Error[0].Exception.Message)
        
        # Re-enable WinRE
        LogMessage("Re-enabling WinRE on error...")
        reagentc /enable
        if (!($LASTEXITCODE -eq 0))
        {
            LogMessage("Warning: encountered an error when enabling WinRE: " + $LASTEXITCODE)
        }
        exit 1
    }
    $OSPartitionAfterShrink = Get-Partition -DriveLetter $OSDrive
    LogMessage("Target partition size: " + $targetOSPartitionSize)
    LogMessage("Size of OS partition after shrinking: " + $OSPartitionAfterShrink.Size)
}

# 2. Delete the WinRE partition
LogMessage("")

if ($WinREIsOnSystemPartition)
{
    LogMessage("Existing WinRE partition is System partition, skipping deletion")
}
else
{    
    # If requested by user, backup rest of the content on WinRE partition to backup directory
    if ($Needbackup)
    {
        $sourcePath = $WinREPartition.AccessPaths[0] 
        LogMessage("Copying content on WinRE partition from [" + $sourcePath + "] to [" + $BackupFolder + "]...")
        
        # Copy-Item may have access issue with certain system folders, enumerate the children items and exlcude them
        $items = Get-ChildItem -LiteralPath $sourcePath -Force
        foreach ($item in $items)
        {
            if ($item.Name -ieq "System Volume Information")
            {
                continue
            }
            $sourceItemPath = Join-Path -Path $sourcePath -ChildPath $item.Name
            $destItemPath = Join-Path -Path $BackupFolder -ChildPath $item.Name
            try 
            {
                LogMessage("Copying [" + $sourceItemPath + "] to [" + $destItemPath + "]...")
                Copy-Item -LiteralPath $sourceItemPath -Destination $destItemPath -Recurse -Force
            } catch 
            {
                LogMessage("Error: An error occurred during copy: $_")
                exit 1
            }
        }
        
        LogMessage("Backup completed")
        LogMessage("")
    }

    LogMessage("Deleting WinRE partition: Disk [" + $OSDiskIndex + "] Partition [" + $WinREPartitionIndex + "]...")
    Remove-Partition -DiskNumber $OSDiskIndex -PartitionNumber $WinREPartitionIndex -Confirm:$false
    if ($Error.Count -gt 0) {
        LogMessage("Error: Remove-Partition encountered errors: " + $Error[0].Exception.Message)
        exit 1
    }
}

# A short sleep for the partition change
Sleep 5

# 3. Create a new WinRE partition
LogMessage("")
LogMessage("Creating new WinRE partition...")
LogMessage("Target size: " + $targetWinREPartitionSize)
if ($diskType -ieq "GPT")
{
    $partition = New-Partition -DiskNumber $OSDiskIndex -Size $targetWinREPartitionSize -GptType "{de94bba4-06d1-4d40-a16a-bfd50179d6ac}"
    
    $newPartitionIndex = $partition.PartitionNumber
    # A short sleep to make sure the partition is ready for formatting
    Sleep 2

    LogMessage("Formating the partition...")
    $result = Format-Volume -Partition $partition -FileSystem NTFS -Confirm:$false
    if ($Error.Count -gt 0) {
        LogMessage("Error: Format-Volume encountered errors: " + $Error[0].Exception.Message)
        exit 1
    }
}
else
{
    #$partition = New-Partition -DiskNumber $OSDiskIndex -Size $targetWinREPartitionSize -MbrType 0x27
    $targetWinREPartitionSizeInMb = [int]($targetWinREPartitionSize/1MB)
    $diskpartScript = 
@"
select disk $OSDiskIndex
create partition primary size=$targetWinREPartitionSizeInMb id=27
format quick fs=ntfs label="Recovery"
set id=27
"@

    $TempPath = $env:Temp
    $diskpartSciptFile = Join-Path -Path $TempPath -ChildPath "\ExtendWinRE_MBR_PowershellScript.txt"
    
    LogMessage("Creating temporary diskpart script to create Recovery partition on MBR disk...")
    LogMessage("Temporary diskpart script file: " + $diskpartSciptFile)
    $diskpartScript | Out-File -FilePath $diskpartSciptFile -Encoding ascii
    
    LogMessage("Executing diskpart script...")
    try 
    {
        $diskpartOutput = diskpart /s $diskpartSciptFile
        
        if ($diskpartOutput -match "DiskPart successfully") 
        {
            LogMessage("Diskpart script executed successfully")
        }
        else
        {
            LogMessage("Error executing diskpart script:" + $diskpartOutput)
            exit 1
        }
        LogMessage("Deleting temporary diskpart script file...")
        Remove-Item $diskpartSciptFile
    }
    catch 
    {
        LogMessage("Error executing diskpart script: $_")
        exit 1
    }
    
    $vol = Get-Volume -FileSystemLabel "Recovery"
    $newPartitionIndex = (Get-Partition | Where-Object { $_.AccessPaths -contains $vol.Path } ).PartitionNumber
}

if ($Error.Count -gt 0) 
{
    LogMessage("Error: New-Partition encountered errors: " + $Error[0].Exception.Message)
    exit 1
}

LogMessage("New Partition index: " + $newPartitionIndex)

# Re-enable WinRE
LogMessage("Re-enabling WinRE...")
reagentc /enable
if (!($LASTEXITCODE -eq 0))
{
    LogMessage("Warning: encountered an error when enabling WinRE: " + $LASTEXITCODE)
    exit $LASTEXITCODE
}

# In the end, Display WinRE status to verify WinRE is enabled correctly
LogMessage("")
LogMessage("WinRE Information:")
$FinalWinREStatus = DisplayWinREStatus
$WinREStatus = $FinalWinREStatus[0]
$WinRELocation = $FinalWinREStatus[1]

if (!$WinREStatus)
{
    LogMessage("Warning: WinRE Disabled")
}

$WinRELocationItems = $WinRELocation.Split('\\')
foreach ($item in $WinRELocationItems)
{
    if ($item -like "partition*")
    {
        $WinREPartitionIndex = ExtractNumbers($item)
    }
}
LogMessage("WinRE Partition Index: " + $WinREPartitionIndex)

$WinREPartition = Get-Partition -DiskNumber $OSDiskIndex -PartitionNumber $WinREPartitionIndex
$WinREPartitionSizeInfoAfter = DisplayPartitionInfo($WinREPartition.AccessPaths)

LogMessage("")
LogMessage("OS Information:")
$OSPartition = Get-Partition -DriveLetter $OSDrive
LogMessage("OS partition size: " + $OSPartition.Size)
LogMessage("OS partition Offset: " + $OSPartition.Offset)

if (!($WinREPartitionIndex -eq $newPartitionIndex))
{
    LogMessage("Warning: WinRE is installed to partition [" + $WinREPartitionIndex +"], but the newly created Recovery partition is [" + $newPartitionIndex + "]")
}

LogMessage("End time: $([DateTime]::Now)")

if ($NeedBackup)
{
    LogMessage("")
    LogMessage("The contents of the old WinRE partition has been backed up to [" + $BackupFolder + "]")
}

LogMessage("")
LogMessage("Successfully completed the operation")

运行示例脚本的步骤

若要运行此示例脚本，请执行以下步骤：

打开文本编辑器。例如，若要打开 Windows 记事本，请右键单击“ 开始”，单击“ 运行”，键入 notepad.exe，然后单击“ 确定”。
将示例脚本复制并粘贴到打开的文本编辑器中。
将脚本文件作为 Powershell_ExtendWinRE_or_CreateNew.ps1 保存到所选位置。例如，将脚本文件保存到 C：/Documents/WinRE_Script。请注意此位置路径，因为将在步骤 7 中使用此路径。
重新启动设备。这一点至关重要，因为设备上可能存在挂起的分区操作，需要先完成这些操作，然后脚本才能安全地增加 WinRE 分区大小。
设备重启后，以管理员身份打开 PowerShell。执行此操作的一种方法是右键单击“开始”，然后单击“终端 (管理员) 。
键入 mkdir <新备份目录的路径> 然后按 Enter。例如，键入 mkdir C：/WinRE_backup，然后按 Enter。这将创建一个名为“WinRE_backup”的备份目录，脚本可以在还原原始分区失败时使用该目录。记下此备份目录的位置。
键入 Powershell.exe -ExecutionPolicy Bypass -File <保存 winre 脚本>的路径 。例如，键入 Powershell.exe -ExecutionPolicy Bypass -File C：/Downloads/WinRE_Script。

注意

假设脚本成功完成，设备现在至少有 250MB 的可用空间，并且能够安装 WinRE 服务更新。
删除在步骤 3 中创建的备份目录，因为不再需要该目录。例如，删除 C：/WinRE_backup 目录。

可能会遇到的问题及其解决方法

如果从脚本收到以下错误消息，则表示设备上没有足够的可用空间来完成重新分区。在这种情况下，请按照释放 Windows 中的驱动器空间Microsoft指南进行操作。执行此操作后，重启设备并再次运行脚本。

注意某些设备的 OS 分区上可能有足够的可用空间，但驱动器过于碎片化，重新分区将无法运行。在这种情况下，请使用本指南对磁盘进行碎片整理。

此脚本假定你已启用 WinRE。如果收到此错误消息，则表示设备没有启用的 WinRE 分区。对于某些工作负载，设备生成器可能会选择不包含 WinRE 分区。如果设备没有 WinRE 分区，则不需要维护服务。如果 WinRE 分区出现问题，请按照 WinRE 故障排除功能中的步骤操作。

尝试在具有自定义分区布局的设备上运行此脚本时，可能会遇到问题，其中设备在操作系统 (操作系统) 分区和恢复分区之间具有另一个分区。若要解决此问题，需要在 OS 分区和恢复分区之间移动或删除分区，以便恢复分区具有与 OS 分区 + 1 相同的索引。

例如，如果 OS 分区为索引 2，则恢复分区应为索引 3。请注意，不要删除或修改任何关键分区，例如系统分区或启动分区。移动或删除分区后，需要重启设备以应用更改并更新分区索引。然后，可以再次运行脚本，该脚本应按预期工作。

KB5035679：运行脚本以重设恢复分区大小以安装 WinRE 更新的说明

摘要

如何使用此脚本将 WinRE 分区大小增加 250 MB

运行示例脚本的步骤

可能会遇到的问题及其解决方法

需要更多帮助?

需要更多选项?

此信息是否有帮助?

谢谢您的反馈！

摘要

如何使用此脚本将 WinRE 分区大小增加 250 MB

示例脚本

运行示例脚本的步骤

可能会遇到的问题及其解决方法

错误：收缩后的目标 OS 分区大小小于支持的最小大小，无法执行重新分区

错误：WinRE 已禁用

自定义分区布局

需要更多帮助?

需要更多选项?

此信息是否有帮助?

谢谢您的反馈！