Added Remove-OldFiles function

Author: alan-null

Tests/WindowsDiskCleanup.Tests.ps1

@@ -0,0 +1,51 @@
+Import-Module .\WindowsDiskCleanup\WindowsDiskCleanup.psm1 -Force
+
+Describe 'WindowsDiskCleanup.Tests' {
+    Context 'Remove-OldFiles Tests' {
+        BeforeAll {
+            $path = "$PSScriptRoot\test.txt"
+        }
+
+        BeforeEach {
+            $file = New-Item -Path $path -ItemType File -Force
+            $file.CreationTimeUtc = (Get-Date).AddDays(-10)
+        }
+
+        AfterEach {
+            if (Test-Path $path) {
+                Remove-Item -Path $path -Force
+            }
+        }
+
+        It 'should remove old file by Path (parameter)' {
+            Remove-OldFiles -Path $file.FullName -Days 5 -DryRun:$false
+            Test-Path $path | Should -Be $false
+        }
+
+        It 'should remove old file by Path (pipeline)' {
+            $file.FullName | Remove-OldFiles -Days 5 -DryRun:$false
+            Test-Path $path | Should -Be $false
+        }
+
+        It 'should remove old file by File (parameter)' {
+            Remove-OldFiles -File $file -Days 5 -DryRun:$false
+            Test-Path $path | Should -Be $false
+        }
+
+        It 'should remove old file by File (pipeline)' {
+            $file | Remove-OldFiles -Days 5 -DryRun:$false
+            Test-Path $path | Should -Be $false
+        }
+
+        It 'should not remove files in dry run mode' {
+            Remove-OldFiles -File $file -Days 5 -DryRun:$true
+            Test-Path $path | Should -Be $true
+        }
+
+        It 'should not remove files that are not old enough' {
+            $file.CreationTimeUtc = (Get-Date).AddDays(-3)
+            Remove-OldFiles -File $file -Days 5 -DryRun:$false
+            Test-Path $path | Should -Be $true
+        }
+    }
+}

WindowsDiskCleanup/Public/Remove-OldFiles.ps1

@@ -0,0 +1,34 @@
+function Remove-OldFiles {
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory = $true, ValueFromPipeline = $true, ParameterSetName = "File")]
+        [System.IO.FileSystemInfo]$File,
+
+        [Parameter(Mandatory = $true, ValueFromPipeline = $true, ParameterSetName = "Path")]
+        [string]$Path,
+
+        [Parameter(Mandatory = $true)]
+        [int]$Days,
+
+        [switch]$DryRun
+    )
+
+    begin {
+        $now = Get-Date
+    }
+
+    process {
+        if ($PSCmdlet.ParameterSetName -eq 'Path') {
+            $File = Get-Item -Path $Path
+        }
+
+        if (($now - $File.CreationTimeUtc).TotalDays -gt $Days) {
+            if ($DryRun) {
+                Write-Host "[Dry] Removing $($File.FullName)" -ForegroundColor Yellow
+            }
+            else {
+                Remove-Item -Path $File.FullName -Force
+            }
+        }
+    }
+}