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

    Fault : Storage Spaces virtual disk detached or degraded
    Fix   : Replace the disk and repair the space
    Source: https://jbtecwiz.com/support/srv-sto-spaces

    Run as     : Elevated PowerShell
    Expect     : 2-12 hours
    Risk       : medium
    Reversible : yes

    WHEN THIS IS THE RIGHT FIX
    Degraded but online. Act promptly -- a second failure on a two-way
    mirror loses the data.

    HOW TO UNDO IT
    Set-PhysicalDisk -Usage AutoSelect returns a retired disk to service if
    it was retired in error.

    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 7"
    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 '  Storage Spaces virtual disk detached or degraded' -ForegroundColor White
Write-Host '  Replace the disk and repair the space' -ForegroundColor Cyan
Write-Host ''
Write-Host '  Risk: medium   Reversible   2-12 hours'
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 'Identify the failed disk and its physical location.' -Command {
    Get-PhysicalDisk | Format-Table FriendlyName,SerialNumber,MediaType,HealthStatus,OperationalStatus,Usage,Size
    Get-VirtualDisk | Format-Table FriendlyName,ResiliencySettingName,HealthStatus,OperationalStatus,Size
}

Invoke-Step -Number 2 -Do 'Turn on the identification light where the enclosure supports it, so the right disk is pulled.' -Why 'Pulling the wrong disk from a degraded pool loses everything. Thirty seconds with the identification light removes the guesswork entirely.' -Command {
    Get-PhysicalDisk -SerialNumber ABC123 | Enable-PhysicalDiskIndication
}

Invoke-Step -Number 3 -Do 'Retire the failed disk so the pool stops trying to use it.' -Command {
    Get-PhysicalDisk -SerialNumber ABC123 | Set-PhysicalDisk -Usage Retired
}

Invoke-Step -Number 4 -Do 'Add the replacement to the pool.' -Command {
    $pool = Get-StoragePool -FriendlyName Pool1
    Get-PhysicalDisk -CanPool $true | Add-PhysicalDisk -StoragePool $pool
}

Invoke-Step -Number 5 -Do 'Start the repair and watch it.' -Command {
    Get-VirtualDisk -FriendlyName Data | Repair-VirtualDisk
    Get-StorageJob | Format-Table Name,JobState,PercentComplete,BytesProcessed
}

Invoke-Step -Number 6 -Do 'Remove the retired disk once the repair completes.' -Command {
    Get-PhysicalDisk -SerialNumber ABC123 | Remove-PhysicalDisk -StoragePool (Get-StoragePool -FriendlyName Pool1)
}

Invoke-Step -Number 7 -Do 'Keep free space in the pool equal to at least one disk, so a future repair can start without waiting for a replacement.' -Why 'A pool with no free capacity cannot begin repairing until new hardware arrives, which extends the window in which a second failure is fatal.' -Manual

Write-Rule "  Confirm it worked"
Show-Prose 'Health is Healthy and no storage jobs remain.' 'White'
Write-Host ''
if (-not $DryRun) {
    Get-VirtualDisk | Format-Table FriendlyName,HealthStatus,OperationalStatus
    Get-StorageJob
}

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/srv-sto-spaces' 'Yellow'
} else {
    Write-Host '  Finished.' -ForegroundColor Green
}
Write-Host ''
Show-Prose 'To undo: Set-PhysicalDisk -Usage AutoSelect returns a retired disk to service if it was retired in error.' 'DarkGray'
Write-Rule