#Requires -Version 5.1
<#
    JbTecWiz Support Centre -- generated fix script

    Fault : 0x8004010F and damaged Outlook data files
    Fix   : Discard and rebuild the OST
    Source: https://jbtecwiz.com/support/win-app-pst-corrupt

    Run as     : PowerShell as the affected user, Outlook closed
    Expect     : 30 minutes plus resync
    Risk       : medium
    Reversible : yes

    WHEN THIS IS THE RIGHT FIX
    It is an OST. The mailbox is on the server, so the local copy can be
    thrown away.

    HOW TO UNDO IT
    Rename the .old file back if the rebuild does not complete.

    This script walks the fix one step at a time and asks before each
    one. Steps with no command are things you do yourself -- it prints
    those and waits. Run with -DryRun to print without executing.

    --------------------------------------------------------------------
    NO WARRANTY - USE AT YOUR OWN RISK

    This script is provided by JbTecWiz as-is and with no warranty of any
    kind, express or implied. You run it entirely at your own risk.

    JbTecWiz accepts no liability for any loss or damage arising from its
    use, including but not limited to data loss, downtime, or configuration
    changes that turn out to be wrong for your system.

    You are responsible for reading this script before running it, for
    satisfying yourself that it suits the machine in front of you, and for
    having a working backup first. Some steps cannot be undone.
    --------------------------------------------------------------------
#>

[CmdletBinding()]
param(
    # Print every step and command without running anything.
    [switch]$DryRun,
    # Do not ask before each step. Read the script first if you use this.
    [switch]$Unattended
)

$ErrorActionPreference = 'Stop'
$script:Failed = 0

function Write-Rule { param([string]$Text)
    Write-Host ''
    Write-Host ('-' * 70) -ForegroundColor DarkGray
    if ($Text) { Write-Host $Text -ForegroundColor Cyan }
}

function Show-Prose { param([string]$Text, [string]$Colour = "Gray")
    if (-not $Text) { return }
    $words = $Text -split "\s+"; $line = "  "
    foreach ($w in $words) {
        if (($line.Length + $w.Length) -gt 74) { Write-Host $line -ForegroundColor $Colour; $line = "  " }
        $line += "$w "
    }
    if ($line.Trim()) { Write-Host $line -ForegroundColor $Colour }
}

function Invoke-Step {
    param(
        [int]$Number, [string]$Do, [string]$Why,
        [scriptblock]$Command, [switch]$Manual, [string]$Shell = "powershell"
    )
    Write-Rule "  Step $Number of 5"
    Show-Prose $Do "White"
    if ($Why) { Write-Host ""; Show-Prose $Why "DarkGray" }

    if ($Manual) {
        Write-Host ''
        Write-Host '  -> Do this yourself, then press Enter to carry on.' -ForegroundColor Yellow
        if (-not $Unattended -and -not $DryRun) { [void](Read-Host) }
        return
    }

    Write-Host ''
    foreach ($l in ($Command.ToString().Trim() -split "`n")) {
        Write-Host ("    " + $l.Trim()) -ForegroundColor Green
    }
    Write-Host ''

    if ($DryRun) { Write-Host "  (dry run -- not executed)" -ForegroundColor DarkGray; return }
    if (-not $Unattended) {
        $a = Read-Host "  Run this step? [Y]es / [S]kip / [Q]uit"
        if ($a -match "^[Qq]") { Write-Host "  Stopped at your request."; exit 0 }
        if ($a -match "^[Ss]") { Write-Host "  Skipped." -ForegroundColor DarkGray; return }
    }
    try { & $Command }
    catch {
        $script:Failed++
        Write-Host ("  Step $Number failed: " + $_.Exception.Message) -ForegroundColor Red
        Show-Prose "The rest of the fix may depend on this. Read the write-up before carrying on." "Red"
        if (-not $Unattended) {
            $c = Read-Host "  Carry on anyway? [y/N]"
            if ($c -notmatch "^[Yy]") { exit 1 }
        }
    }
}

Write-Rule
Write-Host '  0x8004010F and damaged Outlook data files' -ForegroundColor White
Write-Host '  Discard and rebuild the OST' -ForegroundColor Cyan
Write-Host ''
Write-Host '  Risk: medium   Reversible   30 minutes plus resync'
Write-Host ''
Show-Prose 'No warranty. Use at your own risk - JbTecWiz accepts no liability. Read it before you run it, and have a backup.' 'DarkYellow'
Write-Rule

if (-not $Unattended -and -not $DryRun) {
    $go = Read-Host '  Ready? [y/N]'
    if ($go -notmatch "^[Yy]") { Write-Host "  Nothing was changed."; exit 0 }
}

Invoke-Step -Number 1 -Do 'Confirm it is an OST and find it.' -Command {
    Get-ChildItem "$env:LOCALAPPDATA\Microsoft\Outlook" -Filter *.ost | Format-Table Name,Length,LastWriteTime
}

Invoke-Step -Number 2 -Do 'Check for anything stored only locally first -- items in a local folder outside the mailbox, and any PST attached to the same profile. Those are not on the server.' -Why 'The OST is safe to delete only for what is genuinely synchronised. A mailbox with local-only folders, or one that has been archiving to the OST, will lose that content -- check before, not after.' -Manual

Invoke-Step -Number 3 -Do 'Close Outlook and rename rather than delete the file.' -Command {
    Get-Process OUTLOOK -ErrorAction SilentlyContinue | Stop-Process -Force
    Get-ChildItem "$env:LOCALAPPDATA\Microsoft\Outlook\*.ost" | Rename-Item -NewName { $_.Name + '.old' }
}

Invoke-Step -Number 4 -Do 'Start Outlook. It builds a new OST and downloads the mailbox. On a large mailbox this takes hours.' -Manual

Invoke-Step -Number 5 -Do 'Once everything is present, delete the .old file to reclaim the space.' -Manual

Write-Rule "  Confirm it worked"
Show-Prose 'The folder list is complete and Send/Receive completes without error. Compare the item count of a large folder against the web mailbox.' 'White'

Write-Rule
if ($script:Failed -gt 0) {
    Write-Host ("  Finished with " + $script:Failed + " failed step(s).") -ForegroundColor Yellow
    Show-Prose 'Read the full write-up at https://jbtecwiz.com/support/win-app-pst-corrupt' 'Yellow'
} else {
    Write-Host '  Finished.' -ForegroundColor Green
}
Write-Host ''
Show-Prose 'To undo: Rename the .old file back if the rebuild does not complete.' 'DarkGray'
Write-Rule