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

    Fault : Storage Spaces virtual disk detached or degraded
    Fix   : Reattach a detached virtual disk
    Source: https://jbtecwiz.com/support/srv-sto-spaces

    Run as     : Elevated PowerShell
    Expect     : 60 minutes
    Risk       : high
    Reversible : yes

    WHEN THIS IS THE RIGHT FIX
    Detached or Incomplete.

    HOW TO UNDO IT
    None. Do not force anything online with disks missing beyond the
    resiliency level.

    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 6"
    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 '  Reattach a detached virtual disk' -ForegroundColor Cyan
Write-Host ''
Write-Host '  Risk: high   Reversible   60 minutes'
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 'Establish which physical disks are missing.' -Command {
    Get-StoragePool | Format-Table FriendlyName,HealthStatus,OperationalStatus,IsReadOnly
    Get-PhysicalDisk | Format-Table FriendlyName,SerialNumber,HealthStatus,OperationalStatus,Usage
}

Invoke-Step -Number 2 -Do 'Check cabling and controller before any software action. A detached space is frequently a loose SAS cable or an enclosure that lost power, and reattaching without fixing that will not hold.' -Why 'Storage Spaces detaches to protect data when it cannot see enough disks. Forcing it back online with disks still missing is how a recoverable situation becomes a lost one.' -Manual

Invoke-Step -Number 3 -Do 'Clear the read-only flag on the pool, which is set automatically when it detaches.' -Command {
    Get-StoragePool -FriendlyName Pool1 | Set-StoragePool -IsReadOnly $false
}

Invoke-Step -Number 4 -Do 'Reattach the virtual disk.' -Command {
    Get-VirtualDisk -FriendlyName Data | Connect-VirtualDisk
    Get-VirtualDisk | Format-Table FriendlyName,HealthStatus,OperationalStatus
}

Invoke-Step -Number 5 -Do 'Bring the disk online and check the filesystem.' -Command {
    Get-Disk | Where-Object OperationalStatus -eq 'Offline' | Set-Disk -IsOffline $false
    Repair-Volume -DriveLetter E -Scan
}

Invoke-Step -Number 6 -Do 'If more disks are missing than the resiliency can tolerate, the data is not recoverable from the pool and the answer is the backup.' -Manual

Write-Rule "  Confirm it worked"
Show-Prose 'The volume mounts and Repair-Volume -Scan reports no problems.' 'White'
Write-Host ''
if (-not $DryRun) {
    Get-Volume | Format-Table DriveLetter,FileSystemLabel,HealthStatus,SizeRemaining
}

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: None. Do not force anything online with disks missing beyond the resiliency level.' 'DarkGray'
Write-Rule