← Back to System Scripts | Guides & Scripts | Portfolio Home

File Operations

file-operations.ps1 · Download Script

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
# File Operations Functions
# Collection of functions for file and folder operations

function MoveItem-Overwrite {
    <#
    .SYNOPSIS
    Moves an item with overwrite capability
    
    .DESCRIPTION
    Removes the destination if it exists, then moves the source to destination
    
    .PARAMETER Src
    Source path (can be file or folder)
    
    .PARAMETER Dest
    Destination path
    
    .EXAMPLE
    MoveItem-Overwrite -Src "C:\Source\File.txt" -Dest "C:\Destination\File.txt"
    #>
    param (
        [string]$Src,
        [string]$Dest
    )
    Write-Host "--------------------------------------------------------"
    # 1. Remove existing folder (if present)
    if (Test-Path -LiteralPath $Dest) {
        Remove-Item `
            -LiteralPath $Dest `
            -Recurse `
            -Force
        Write-Host "Removed existing folder/file at '$Dest'."
    }

    # 2. Move the source folder
    Move-Item `
        -LiteralPath $Src `
        -Destination $Dest `
        -Force
    if (Test-Path -LiteralPath $Dest) {
        Write-Host "Move operation successful." -ForegroundColor Green
        Write-Host "Moved folder from '$Src' to '$Dest'."
    } else {
        Write-Host "Move operation failed." -ForegroundColor Red
    }
    Write-Host "--------------------------------------------------------"
}

function RenameFolders-FirstLetterUppercase {
    <#
    .SYNOPSIS
    Renames all folders to have first letter uppercase
    
    .DESCRIPTION
    Enumerates all directories and renames them with first letter capitalized
    
    .PARAMETER Path
    The path to process (default is current directory)
    
    .EXAMPLE
    RenameFolders-FirstLetterUppercase -Path "C:\MyFolder"
    #>
    [CmdletBinding(SupportsShouldProcess=$true, ConfirmImpact='Medium')]
    param(
        [Parameter(Mandatory=$false)]
        [string]$Path = '.'
    )

    # Enumerate all directories under the specified path
    Get-ChildItem -Path $Path -Directory | ForEach-Object {
        $oldName = $_.Name
        $parentPath = $_.Parent.FullName
        Write-Host "Processing folder: $oldName"
        if ($oldName.Length -ge 1) {
            # Construct the new folder name
            $newName = $oldName.Substring(0,1).ToUpper() + $oldName.Substring(1)
            Write-Host "New folder name will be: $newName"
            if ($newName -cne $oldName) {
                $oldFullPath = $_.FullName
                $newFullPath = Join-Path -Path $parentPath -ChildPath $newName
                Write-Host "Old full path: $oldFullPath"
                Write-Host "New full path: $newFullPath"
                Write-Host "Considering rename of $oldName to $newName"
                # Handle case-only on NTFS
                if ($oldName.ToLower() -eq $newName.ToLower()) {
                    $tmpName     = "{0}_tmp_{1}" -f $newName, ([guid]::NewGuid().ToString('N'))
                    $tmpFullPath = Join-Path $parentPath $tmpName

                    Move-Item -LiteralPath $oldFullPath -Destination $tmpFullPath -Force
                    Move-Item -LiteralPath $tmpFullPath -Destination $newFullPath -Force

                    Write-Host "Case-only rename: '$oldName' → '$newName' via temp '$tmpName'"
                }
                else {
                    Move-Item -LiteralPath $oldFullPath -Destination $newFullPath -Force
                    Write-Host "Renamed '$oldName' to '$newName'"
                }
            }
        }
    }
}

function ListSize-Directory {
    <#
    .SYNOPSIS
    Lists all directories and their sizes in GB
    
    .DESCRIPTION
    Suitable for locating where data storage is centralized
    
    .PARAMETER Path
    The parent directory to analyze (default is current directory)
    
    .EXAMPLE
    ListSize-Directory
    ListSize-Directory -Path "C:\MyFolder"
    #>
    param(
        [string]$Path = (Get-Location).Path
    )
    
    Write-Host "Parent-Dir ${Path}"
    Get-ChildItem -Path $Path -Directory | ForEach-Object {
        $folderPath = $_.FullName
        $lastElement = Split-Path -Path $folderPath -Leaf
        $sizeInBytes = (Get-ChildItem -Path $folderPath -Recurse -File -ErrorAction SilentlyContinue | Measure-Object -Property Length -Sum).Sum
        $sizeInGB = $sizeInBytes / 1GB
        Write-Host "Child-Dir ${lastElement}: $("{0:N2}" -f $sizeInGB) GB"
    }
}

# Export functions
Export-ModuleMember -Function MoveItem-Overwrite, RenameFolders-FirstLetterUppercase, ListSize-Directory