Move all contents of a directory for future disposal

Move-For-Deletion.ps1

<#
.SYNOPSIS
Moves contents from one directory to a temporary deletion folder.

.DESCRIPTION
This script safely moves files and folders from a specified directory to a randomly named
temporary folder. It preserves the original directory structure and handles the move operation
with error suppression.

Why? When you need to delete a directory such as a large .NET app webroot, there can be hundreds of
thousands of files and folders. Deleting such a large directory can take a long time. For lightning fast
CI/CD, we need to clear this out so the code can be replaced as quickly as possible

#>

$StartTime = Get-Date

$sourcePath = "C:\Web\LargeWebroot"
$destinationBasePath = "C:\Temp\ToDelete"

# Generate a random number for the destination folder
$randomNumber = Get-Random -Maximum 1000000
$destinationPath = Join-Path $destinationBasePath $randomNumber

# Create the destination folder if it doesn't exist
if (-not (Test-Path $destinationPath)) {
    New-Item -Path $destinationPath -ItemType Directory
}

# Move all files and subfolders to the new destination
Get-ChildItem -Path $sourcePath -Recurse | ForEach-Object {
    $dest = Join-Path $destinationPath -ChildPath $_.FullName.Substring($sourcePath.Length)
    $destDir = Split-Path $dest

    # Check if the destination directory exists before creating it
    if (-not (Test-Path $destDir)) {
        New-Item -ItemType Directory -Path $destDir
    }
    
    Move-Item -Path $_.FullName -Destination $dest -Force -ErrorAction SilentlyContinue
}

$FinishTime = Get-Date
$TotalTime = ($FinishTime - $StartTime).TotalSeconds
Write-Host "This took $TotalTime s."