Improve repository structure and documentation

Add descriptions and reorganize scripts into subdirectories.

* **README.md**: Add a brief description of the purpose and usage of the scripts. Add a section for the new subdirectories and their purposes.
* **PasswordExpirationNotification/README.md**: Add a brief description of the purpose and usage of the `PasswordExpirationNotification` script.
* **CleanLogsAccessDeniedFix.ps1**: Rename to `Logging/CleanLogsAccessDeniedFix.ps1`. Add comments at the beginning of the script to provide an overview of its purpose and functionality. Add error handling and logging.
* **DeleteOldFiles.ps1**: Rename to `Logging/DeleteOldFiles.ps1`. Add comments at the beginning of the script to provide an overview of its purpose and functionality. Add error handling and logging.

---

For more details, open the [Copilot Workspace session](https://copilot-workspace.githubnext.com/orguetta/SystemAdminScripts?shareId=XXXX-XXXX-XXXX-XXXX).

Author: orguetta

CleanLogsAccessDeniedFix/CleanLogsAccessDeniedFix.ps1

@@ -0,0 +1,58 @@
+# This script is designed to fix access denied errors when cleaning up log files.
+# It attempts to delete log files and handles access denied errors by taking ownership of the files and retrying the deletion.
+
+# Set the path to the log files and the number of days to keep the files.
+$logPath = "C:\Logs"
+$daysToKeep = 30
+$limit = (Get-Date).AddDays(-$daysToKeep)
+
+# Function to take ownership of a file.
+function Take-Ownership {
+    param (
+        [string]$filePath
+    )
+    try {
+        $user = [System.Security.Principal.WindowsIdentity]::GetCurrent().Name
+        $takeown = Start-Process -FilePath "takeown.exe" -ArgumentList "/F `"$filePath`"" -Wait -NoNewWindow -PassThru
+        $icacls = Start-Process -FilePath "icacls.exe" -ArgumentList "`"$filePath`" /grant `$user`:F" -Wait -NoNewWindow -PassThru
+        Write-Host "Ownership taken for file: $filePath" -ForegroundColor Green
+    } catch {
+        Write-Host "Error taking ownership of file: $filePath" -ForegroundColor Red
+    }
+}
+
+# Function to delete old log files and handle access denied errors.
+function Delete-OldLogs {
+    param (
+        [string]$path,
+        [datetime]$dateLimit
+    )
+    try {
+        Get-ChildItem -Path $path -Recurse -Force | Where-Object { !$_.PSIsContainer -and $_.CreationTime -lt $dateLimit } | ForEach-Object {
+            try {
+                Remove-Item -Path $_.FullName -Force
+                Write-Host "Deleted file: $($_.FullName)" -ForegroundColor Green
+            } catch {
+                if ($_.Exception -match "Access to the path") {
+                    Write-Host "Access denied for file: $($_.FullName). Attempting to take ownership." -ForegroundColor Yellow
+                    Take-Ownership -filePath $_.FullName
+                    try {
+                        Remove-Item -Path $_.FullName -Force
+                        Write-Host "Deleted file after taking ownership: $($_.FullName)" -ForegroundColor Green
+                    } catch {
+                        Write-Host "Error deleting file after taking ownership: $($_.FullName)" -ForegroundColor Red
+                    }
+                } else {
+                    Write-Host "Error deleting file: $($_.FullName)" -ForegroundColor Red
+                }
+            }
+        }
+    } catch {
+        Write-Host "Error processing log files in path: $path" -ForegroundColor Red
+    }
+}
+
+# Main script execution
+Write-Host "Starting log cleanup..." -ForegroundColor Cyan
+Delete-OldLogs -path $logPath -dateLimit $limit
+Write-Host "Log cleanup completed." -ForegroundColor Cyan

DeleteOldFiles/DeleteOldFiles.ps1

@@ -0,0 +1,44 @@
+# This script is designed to delete old files from a specified directory.
+# It deletes files that are older than a specified number of days.
+# The script includes error handling to manage potential issues during execution.
+# Logging is added to record important events and errors for troubleshooting purposes.
+
+# Set the path to the directory and the number of days to keep the files.
+$directoryPath = "C:\Temp"
+$daysToKeep = 30
+$limit = (Get-Date).AddDays(-$daysToKeep)
+
+# Function to delete old files and handle errors.
+function Delete-OldFiles {
+    param (
+        [string]$path,
+        [datetime]$dateLimit
+    )
+    try {
+        Get-ChildItem -Path $path -Recurse -Force | Where-Object { !$_.PSIsContainer -and $_.CreationTime -lt $dateLimit } | ForEach-Object {
+            try {
+                Remove-Item -Path $_.FullName -Force
+                Write-Host "Deleted file: $($_.FullName)" -ForegroundColor Green
+                # Log the deletion of the file
+                Add-Content -Path "C:\Temp\DeleteOldFiles.log" -Value "Deleted file: $($_.FullName) at $(Get-Date)"
+            } catch {
+                Write-Host "Error deleting file: $($_.FullName)" -ForegroundColor Red
+                # Log the error
+                Add-Content -Path "C:\Temp\DeleteOldFiles.log" -Value "Error deleting file: $($_.FullName) at $(Get-Date) - $($_.Exception.Message)"
+            }
+        }
+    } catch {
+        Write-Host "Error processing files in path: $path" -ForegroundColor Red
+        # Log the error
+        Add-Content -Path "C:\Temp\DeleteOldFiles.log" -Value "Error processing files in path: $path at $(Get-Date) - $($_.Exception.Message)"
+    }
+}
+
+# Main script execution
+Write-Host "Starting file deletion..." -ForegroundColor Cyan
+# Log the start of the file deletion process
+Add-Content -Path "C:\Temp\DeleteOldFiles.log" -Value "Starting file deletion at $(Get-Date)"
+Delete-OldFiles -path $directoryPath -dateLimit $limit
+Write-Host "File deletion completed." -ForegroundColor Cyan
+# Log the completion of the file deletion process
+Add-Content -Path "C:\Temp\DeleteOldFiles.log" -Value "File deletion completed at $(Get-Date)"

Logging/CleanLogsAccessDeniedFix.ps1

@@ -1,2 +1,15 @@
-# passwordex 
-is a script for send to users in doamin to change password
+# PasswordExpirationNotification
+
+The `PasswordExpirationNotification` script is designed to send email notifications to users in a domain to remind them to change their passwords before they expire. The script checks the password expiration date for each user and sends an email notification if the password is about to expire.
+
+## Usage
+
+1. Ensure you have the necessary permissions to run the script and access the required resources.
+2. Update the script with the appropriate settings, such as email addresses, SMTP server, and domain information.
+3. Run the script as needed to send password expiration notifications to users.
+
+## Requirements
+
+- PowerShell
+- Active Directory module for PowerShell
+- Access to an SMTP server for sending email notifications

Logging/DeleteOldFiles.ps1

@@ -1,2 +1,27 @@
 # SystemAdminScripts
-Scripts for System administrator & system security  administrator
+
+Scripts for System administrator & system security administrator
+
+## Purpose and Usage
+
+This repository contains various scripts designed to assist system administrators and system security administrators in managing and securing their environments. The scripts cover a range of tasks, including log management, user management, and security tasks.
+
+## Subdirectories
+
+The scripts in this repository are organized into subdirectories based on their functionality:
+
+- `Logging`: Contains scripts related to log management, such as cleaning up old log files and deleting old files.
+- `Security`: Contains scripts related to security tasks, such as sending alerts for domain admin additions and user lockouts, as well as notifying users about password expiration.
+- `UserManagement`: Contains scripts related to user management, such as generating reports on inactive users and deleting user profiles across multiple servers.
+
+## Usage
+
+1. Ensure you have the necessary permissions to run the scripts and access the required resources.
+2. Update the scripts with the appropriate settings, such as email addresses, SMTP servers, and file paths.
+3. Run the scripts as needed to perform the desired tasks.
+
+## Requirements
+
+- PowerShell
+- Active Directory module for PowerShell (for scripts that interact with Active Directory)
+- Access to an SMTP server for sending email notifications (for scripts that send emails)