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

    Fault : Users cannot save to a share that has plenty of free space
    Fix   : Find the quota that is being hit
    Source: https://jbtecwiz.com/support/srv-sto-fsrm-quota

    Run as     : Elevated PowerShell on the file server
    Expect     : 25 minutes
    Risk       : medium
    Reversible : yes

    WHEN THIS IS THE RIGHT FIX
    A folder or user cannot write.

    HOW TO UNDO IT
    Set-FsrmQuota with the previous size.

    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 '  Users cannot save to a share that has plenty of free space' -ForegroundColor White
Write-Host '  Find the quota that is being hit' -ForegroundColor Cyan
Write-Host ''
Write-Host '  Risk: medium   Reversible   25 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 'List the FSRM quotas and their usage.' -Command {
    Get-FsrmQuota | Format-Table Path,Size,Usage,SoftLimit,Template -AutoSize
}

Invoke-Step -Number 2 -Do 'Check for auto-apply quota templates, which create a quota on each subfolder automatically and are easy to forget about.' -Why 'An auto-apply template on a home directory root creates an individual quota for every user folder. The quota that is full will not appear in a listing of the parent, which is why this is so often missed.' -Command {
    Get-FsrmAutoQuota | Format-Table Path,Template
}

Invoke-Step -Number 3 -Do 'Check NTFS disk quotas as well, which are a separate mechanism on the volume.' -Command {
    fsutil quota query E:
}

Invoke-Step -Number 4 -Do 'Raise the specific quota, or move the user to a larger template.' -Command {
    Set-FsrmQuota -Path 'E:\Users\jbloggs' -Size 20GB
}

Invoke-Step -Number 5 -Do 'Check whether the space is genuinely needed, or whether an old profile or PST is sitting in the folder.' -Command {
    Get-ChildItem 'E:\Users\jbloggs' -Recurse -File | Sort-Object Length -Descending | Select-Object -First 15 FullName,@{n='MB';e={[math]::Round($_.Length/1MB,1)}}
}

Invoke-Step -Number 6 -Do 'Set the notification thresholds so users are warned before they are stopped.' -Command {
    Get-FsrmQuotaTemplate | Format-Table Name,Size,SoftLimit
}

Write-Rule "  Confirm it worked"
Show-Prose 'The user can save, and the quota usage is below the limit.' 'White'
Write-Host ''
if (-not $DryRun) {
    Get-FsrmQuota -Path 'E:\Users\jbloggs' | Format-List Path,Size,Usage,PeakUsage
}

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-fsrm-quota' 'Yellow'
} else {
    Write-Host '  Finished.' -ForegroundColor Green
}
Write-Host ''
Show-Prose 'To undo: Set-FsrmQuota with the previous size.' 'DarkGray'
Write-Rule