diff --git a/Chunked-Test.ps1 b/Chunked-Test.ps1
deleted file mode 100644
index bc73d51..0000000
--- a/Chunked-Test.ps1
+++ /dev/null
@@ -1,135 +0,0 @@
-# Chunked upload test with large Windows install.wim file
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== PSMinIO Chunked Upload Test ===" -ForegroundColor Cyan
-Write-Host ""
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-# Large test file
-$testFile = "C:\Users\gsadmin\Downloads\windows_10_enterprise_ltsc_2021_x64\sources\install.wim"
-
-# Check if file exists
-if (-not (Test-Path $testFile)) {
- Write-Host "ERROR: Test file not found: $testFile" -ForegroundColor Red
- exit 1
-}
-
-# Get file info
-$fileInfo = Get-Item $testFile
-Write-Host "Test file: $($fileInfo.Name)" -ForegroundColor Yellow
-Write-Host "File size: $([math]::Round($fileInfo.Length / 1MB, 2)) MB ($($fileInfo.Length) bytes)" -ForegroundColor Yellow
-Write-Host ""
-
-# Connect
-Write-Host "1. Connecting to MinIO..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey -Verbose
- Write-Host "SUCCESS: Connected to $($connection.EndpointUrl)" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- exit 1
-}
-
-# Get bucket
-$buckets = Get-MinIOBucket
-if ($buckets.Count -eq 0) {
- Write-Host "ERROR: No buckets available for testing" -ForegroundColor Red
- exit 1
-}
-$testBucket = $buckets[0].Name
-Write-Host "Using bucket: $testBucket" -ForegroundColor Yellow
-Write-Host ""
-
-# Test chunked upload with different chunk sizes
-$chunkSizes = @(
- @{ Size = "10MB"; Bytes = 10MB },
- @{ Size = "50MB"; Bytes = 50MB }
-)
-
-foreach ($chunkConfig in $chunkSizes) {
- Write-Host "2. Testing chunked upload with $($chunkConfig.Size) chunks..." -ForegroundColor Yellow
-
- try {
- $startTime = Get-Date
-
- # Perform chunked upload
- $uploadResult = New-MinIOObjectChunked -BucketName $testBucket -Files $testFile -ChunkSize $chunkConfig.Bytes -Verbose
-
- $endTime = Get-Date
- $duration = $endTime - $startTime
- $speedMBps = [math]::Round(($fileInfo.Length / 1MB) / $duration.TotalSeconds, 2)
-
- Write-Host "SUCCESS: Chunked upload completed!" -ForegroundColor Green
- Write-Host "Duration: $($duration.ToString('mm\:ss\.fff'))" -ForegroundColor Gray
- Write-Host "Average speed: $speedMBps MB/s" -ForegroundColor Gray
- Write-Host ""
-
- # Display result
- $uploadResult | Format-Table ObjectName, BucketName, Size, @{
- Name = "SizeMB"
- Expression = { [math]::Round($_.Size / 1MB, 2) }
- }
-
- # Test chunked download
- Write-Host "3. Testing chunked download with $($chunkConfig.Size) chunks..." -ForegroundColor Yellow
-
- $downloadFile = "downloaded-$($fileInfo.Name)"
-
- try {
- $downloadStartTime = Get-Date
-
- # Perform chunked download
- $downloadResult = Get-MinIOObjectContentChunked -BucketName $testBucket -ObjectName $fileInfo.Name -FilePath $downloadFile -ChunkSize $chunkConfig.Bytes -Force -Verbose
-
- $downloadEndTime = Get-Date
- $downloadDuration = $downloadEndTime - $downloadStartTime
- $downloadSpeedMBps = [math]::Round(($fileInfo.Length / 1MB) / $downloadDuration.TotalSeconds, 2)
-
- Write-Host "SUCCESS: Chunked download completed!" -ForegroundColor Green
- Write-Host "Duration: $($downloadDuration.ToString('mm\:ss\.fff'))" -ForegroundColor Gray
- Write-Host "Average speed: $downloadSpeedMBps MB/s" -ForegroundColor Gray
-
- # Verify file size
- $downloadedFileInfo = Get-Item $downloadFile
- if ($downloadedFileInfo.Length -eq $fileInfo.Length) {
- Write-Host "SUCCESS: File size verification passed ($($downloadedFileInfo.Length) bytes)" -ForegroundColor Green
- } else {
- Write-Host "WARNING: File size mismatch - Original: $($fileInfo.Length), Downloaded: $($downloadedFileInfo.Length)" -ForegroundColor Yellow
- }
-
- # Cleanup downloaded file
- Remove-Item $downloadFile -Force -ErrorAction SilentlyContinue
-
- } catch {
- Write-Host "FAILED: Download error - $($_.Exception.Message)" -ForegroundColor Red
- }
-
- # Cleanup uploaded file from bucket
- Write-Host "4. Cleaning up uploaded file..." -ForegroundColor Yellow
- try {
- Remove-MinIOObject -BucketName $testBucket -ObjectName $fileInfo.Name -Force -Verbose
- Write-Host "SUCCESS: Cleanup completed" -ForegroundColor Green
- } catch {
- Write-Host "WARNING: Cleanup failed - $($_.Exception.Message)" -ForegroundColor Yellow
- }
-
- Write-Host ""
- Write-Host "--- Test with $($chunkConfig.Size) chunks completed ---" -ForegroundColor Cyan
- Write-Host ""
-
- # Only test one chunk size for now to avoid long test times
- break
-
- } catch {
- Write-Host "FAILED: Upload error - $($_.Exception.Message)" -ForegroundColor Red
- Write-Host "Inner Exception: $($_.Exception.InnerException.Message)" -ForegroundColor Red
- break
- }
-}
-
-Write-Host "=== Chunked Test Suite Complete ===" -ForegroundColor Cyan
-Write-Host "✅ Large file chunked upload/download with progress tracking" -ForegroundColor Green
diff --git a/Debug-Test.ps1 b/Debug-Test.ps1
deleted file mode 100644
index ed10379..0000000
--- a/Debug-Test.ps1
+++ /dev/null
@@ -1,39 +0,0 @@
-# Debug test for PSMinIO module
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== PSMinIO Debug Test ===" -ForegroundColor Cyan
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-Write-Host "1. Connecting..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
- Write-Host "SUCCESS: Connected to $($connection.EndpointUrl)" -ForegroundColor Green
-
- # Check if connection is stored in session variable
- Write-Host "2. Checking session variable..." -ForegroundColor Yellow
- $sessionConnection = Get-Variable -Name "MinIOConnection" -ErrorAction SilentlyContinue
- if ($sessionConnection) {
- Write-Host "SUCCESS: Session variable exists with value type: $($sessionConnection.Value.GetType().Name)" -ForegroundColor Green
- Write-Host "Session connection endpoint: $($sessionConnection.Value.EndpointUrl)" -ForegroundColor Gray
- } else {
- Write-Host "FAILED: Session variable not found" -ForegroundColor Red
- }
-
- # Try to manually call Get-MinIOBucket with explicit connection
- Write-Host "3. Testing with explicit connection..." -ForegroundColor Yellow
- try {
- $buckets = Get-MinIOBucket -MinIOConnection $connection
- Write-Host "SUCCESS: Found $($buckets.Count) buckets with explicit connection" -ForegroundColor Green
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-Write-Host "Debug test completed!" -ForegroundColor Cyan
diff --git a/File-Handle-Test.ps1 b/File-Handle-Test.ps1
deleted file mode 100644
index 067fa4a..0000000
--- a/File-Handle-Test.ps1
+++ /dev/null
@@ -1,93 +0,0 @@
-# Test file handle release
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== File Handle Test ===" -ForegroundColor Cyan
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-# Connect
-$connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
-$buckets = Get-MinIOBucket
-$testBucket = $buckets[0].Name
-
-Write-Host "Testing file handle release with bucket: $testBucket" -ForegroundColor Yellow
-
-# Test 1: Create file, upload, try to delete immediately
-Write-Host "1. Testing immediate file deletion after upload..." -ForegroundColor Yellow
-$testFile1 = "handle-test-1.txt"
-"Test content 1" | Out-File -FilePath $testFile1 -Encoding UTF8
-
-try {
- # Upload
- $result = New-MinIOObject -BucketName $testBucket -Files $testFile1
- Write-Host "Upload successful" -ForegroundColor Green
-
- # Try to delete immediately
- Remove-Item $testFile1 -Force
- Write-Host "SUCCESS: File deleted immediately after upload" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-# Test 2: Create file, upload, wait a bit, then delete
-Write-Host "2. Testing file deletion after short delay..." -ForegroundColor Yellow
-$testFile2 = "handle-test-2.txt"
-"Test content 2" | Out-File -FilePath $testFile2 -Encoding UTF8
-
-try {
- # Upload
- $result = New-MinIOObject -BucketName $testBucket -Files $testFile2
- Write-Host "Upload successful" -ForegroundColor Green
-
- # Wait a bit
- Start-Sleep -Seconds 2
-
- # Try to delete
- Remove-Item $testFile2 -Force
- Write-Host "SUCCESS: File deleted after delay" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-# Test 3: Download and immediate delete
-Write-Host "3. Testing download and immediate delete..." -ForegroundColor Yellow
-$downloadFile = "downloaded-handle-test.txt"
-
-try {
- # Download
- $result = Get-MinIOObjectContent -BucketName $testBucket -ObjectName $testFile1 -FilePath $downloadFile -Force
- Write-Host "Download successful" -ForegroundColor Green
-
- # Try to delete immediately
- Remove-Item $downloadFile -Force
- Write-Host "SUCCESS: Downloaded file deleted immediately" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-# Test 4: Force garbage collection and retry
-Write-Host "4. Testing with garbage collection..." -ForegroundColor Yellow
-$testFile3 = "handle-test-3.txt"
-"Test content 3" | Out-File -FilePath $testFile3 -Encoding UTF8
-
-try {
- # Upload
- $result = New-MinIOObject -BucketName $testBucket -Files $testFile3
- Write-Host "Upload successful" -ForegroundColor Green
-
- # Force garbage collection
- [System.GC]::Collect()
- [System.GC]::WaitForPendingFinalizers()
- [System.GC]::Collect()
-
- # Try to delete
- Remove-Item $testFile3 -Force
- Write-Host "SUCCESS: File deleted after GC" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-Write-Host "File handle test completed!" -ForegroundColor Cyan
diff --git a/Final-Clean-Test.ps1 b/Final-Clean-Test.ps1
deleted file mode 100644
index c42dec9..0000000
--- a/Final-Clean-Test.ps1
+++ /dev/null
@@ -1,92 +0,0 @@
-# Final clean test for PSMinIO module with MinIO 4.0.7
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== PSMinIO Module Final Test ===" -ForegroundColor Cyan
-Write-Host ""
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-# Test 1: Connection with automatic session variable
-Write-Host "1. Connection Test (with automatic session variable)..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey -Verbose
- Write-Host "SUCCESS: Connected to $($connection.EndpointUrl)" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- exit 1
-}
-
-# Test 2: Bucket Listing (using session variable)
-Write-Host "2. Bucket Listing Test (using session variable)..." -ForegroundColor Yellow
-try {
- $buckets = Get-MinIOBucket -Verbose
- Write-Host "SUCCESS: Found $($buckets.Count) buckets" -ForegroundColor Green
- if ($buckets.Count -gt 0) {
- $buckets | Format-Table Name, CreationDate
- }
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-# Test 3: Bucket Listing (with explicit connection)
-Write-Host "3. Bucket Listing Test (with explicit connection)..." -ForegroundColor Yellow
-try {
- $buckets2 = Get-MinIOBucket -MinIOConnection $connection -Verbose
- Write-Host "SUCCESS: Found $($buckets2.Count) buckets with explicit connection" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-# Test 4: Create test bucket if none exist
-if ($buckets.Count -eq 0) {
- Write-Host "4. Creating Test Bucket..." -ForegroundColor Yellow
- try {
- $testBucketName = "psminiotest$(Get-Random -Minimum 1000 -Maximum 9999)"
- New-MinIOBucket -BucketName $testBucketName -Verbose
- Write-Host "SUCCESS: Created bucket $testBucketName" -ForegroundColor Green
- $buckets = Get-MinIOBucket
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-}
-
-# Test 5: File Upload (if we have buckets)
-if ($buckets.Count -gt 0) {
- $testBucket = $buckets[0].Name
- Write-Host "5. File Upload Test to bucket '$testBucket'..." -ForegroundColor Yellow
-
- # Create test file
- $testFile = "test-upload.txt"
- "Test content created at $(Get-Date)" | Out-File -FilePath $testFile -Encoding UTF8
-
- try {
- $uploadResult = New-MinIOObject -BucketName $testBucket -Files $testFile -Verbose
- Write-Host "SUCCESS: Uploaded $testFile" -ForegroundColor Green
- $uploadResult | Format-Table ObjectName, BucketName, Size
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-
- # Test 6: File Download
- Write-Host "6. File Download Test..." -ForegroundColor Yellow
- try {
- $downloadFile = "downloaded-test.txt"
- $downloadResult = Get-MinIOObjectContent -BucketName $testBucket -ObjectName $testFile -FilePath $downloadFile -Force -Verbose
- Write-Host "SUCCESS: Downloaded to $($downloadResult.FullName)" -ForegroundColor Green
- Write-Host "Content: $(Get-Content $downloadFile)" -ForegroundColor Gray
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-
- # Cleanup test files
- @($testFile, $downloadFile) | ForEach-Object {
- if (Test-Path $_) { Remove-Item $_ -Force }
- }
-}
-
-Write-Host ""
-Write-Host "=== Test Suite Complete ===" -ForegroundColor Cyan
-Write-Host "✅ MinIO 4.0.7 with clean logging and automatic session management" -ForegroundColor Green
diff --git a/Final-Test.ps1 b/Final-Test.ps1
deleted file mode 100644
index 23b6609..0000000
--- a/Final-Test.ps1
+++ /dev/null
@@ -1,109 +0,0 @@
-# Final comprehensive test for PSMinIO module
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== PSMinIO Module Test Suite ===" -ForegroundColor Cyan
-Write-Host ""
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-# Test 1: Connection
-Write-Host "1. Connection Test..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
- Write-Host "SUCCESS: Connected to $($connection.EndpointUrl)" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- exit 1
-}
-
-# Test 2: Bucket Listing
-Write-Host "2. Bucket Listing Test..." -ForegroundColor Yellow
-try {
- $buckets = Get-MinIOBucket
- Write-Host "SUCCESS: Found $($buckets.Count) buckets" -ForegroundColor Green
- if ($buckets.Count -gt 0) {
- $buckets | Select-Object Name, CreationDate | Format-Table
- }
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-# Test 3: Create test bucket if none exist
-if ($buckets.Count -eq 0) {
- Write-Host "3. Creating Test Bucket..." -ForegroundColor Yellow
- try {
- $testBucketName = "psminiotest$(Get-Random -Minimum 1000 -Maximum 9999)"
- New-MinIOBucket -BucketName $testBucketName
- Write-Host "SUCCESS: Created bucket $testBucketName" -ForegroundColor Green
- $buckets = Get-MinIOBucket
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-}
-
-# Test 4: File Upload
-if ($buckets.Count -gt 0) {
- $testBucket = $buckets[0].Name
- Write-Host "4. File Upload Test to bucket '$testBucket'..." -ForegroundColor Yellow
-
- # Create test file
- $testFile = "test-upload.txt"
- "Test content created at $(Get-Date)" | Out-File -FilePath $testFile -Encoding UTF8
-
- try {
- $uploadResult = New-MinIOObject -BucketName $testBucket -Files $testFile
- Write-Host "SUCCESS: Uploaded $testFile" -ForegroundColor Green
- $uploadResult | Format-Table ObjectName, BucketName, Size
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-
- # Test 5: File Download
- Write-Host "5. File Download Test..." -ForegroundColor Yellow
- try {
- $downloadFile = "downloaded-test.txt"
- $downloadResult = Get-MinIOObjectContent -BucketName $testBucket -ObjectName $testFile -FilePath $downloadFile -Force
- Write-Host "SUCCESS: Downloaded to $($downloadResult.FullName)" -ForegroundColor Green
- Write-Host "Content: $(Get-Content $downloadFile)" -ForegroundColor Gray
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-
- # Test 6: Chunked Upload
- Write-Host "6. Chunked Upload Test..." -ForegroundColor Yellow
- try {
- $chunkedFile = "chunked-test.txt"
- $content = @()
- for ($i = 1; $i -le 100; $i++) {
- $content += "Line $i of chunked test file created at $(Get-Date)"
- }
- $content | Out-File -FilePath $chunkedFile -Encoding UTF8
-
- $chunkedResult = New-MinIOObjectChunked -BucketName $testBucket -Files $chunkedFile -ChunkSize 1KB
- Write-Host "SUCCESS: Chunked upload completed" -ForegroundColor Green
- $chunkedResult | Format-Table ObjectName, BucketName, Size
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-
- # Test 7: Chunked Download
- Write-Host "7. Chunked Download Test..." -ForegroundColor Yellow
- try {
- $chunkedDownload = "chunked-downloaded.txt"
- $chunkedDownloadResult = Get-MinIOObjectContentChunked -BucketName $testBucket -ObjectName $chunkedFile -FilePath $chunkedDownload -ChunkSize 1KB -Force
- Write-Host "SUCCESS: Chunked download completed to $($chunkedDownloadResult.FullName)" -ForegroundColor Green
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-
- # Cleanup test files
- @($testFile, $downloadFile, $chunkedFile, $chunkedDownload) | ForEach-Object {
- if (Test-Path $_) { Remove-Item $_ -Force }
- }
-}
-
-Write-Host ""
-Write-Host "=== Test Suite Complete ===" -ForegroundColor Cyan
diff --git a/Large-File-Test.ps1 b/Large-File-Test.ps1
deleted file mode 100644
index aa41b1f..0000000
--- a/Large-File-Test.ps1
+++ /dev/null
@@ -1,105 +0,0 @@
-# Large file chunked upload test
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== Large File Chunked Upload Test ===" -ForegroundColor Cyan
-Write-Host ""
-
-# Test file
-$testFile = "C:\Users\gsadmin\Downloads\windows_10_enterprise_ltsc_2021_x64\sources\install.wim"
-
-# Check file
-if (Test-Path $testFile) {
- $fileInfo = Get-Item $testFile
- Write-Host "File: $($fileInfo.Name)" -ForegroundColor Yellow
- Write-Host "Size: $([math]::Round($fileInfo.Length / 1GB, 2)) GB ($([math]::Round($fileInfo.Length / 1MB, 0)) MB)" -ForegroundColor Yellow
-} else {
- Write-Host "File not found!" -ForegroundColor Red
- exit 1
-}
-
-# Connect
-Write-Host "Connecting..." -ForegroundColor Yellow
-$connection = Connect-MinIO -Endpoint "https://api.s3.gracesolution.info" -AccessKey "T34Wg85SAwezUa3sk3m4" -SecretKey "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-# Get bucket
-$buckets = Get-MinIOBucket
-$testBucket = $buckets[0].Name
-Write-Host "Using bucket: $testBucket" -ForegroundColor Yellow
-Write-Host ""
-
-# Test chunked upload with 50MB chunks
-Write-Host "Starting chunked upload with 50MB chunks..." -ForegroundColor Yellow
-Write-Host "This may take several minutes for a 3.7GB file..." -ForegroundColor Gray
-
-try {
- $startTime = Get-Date
-
- $result = New-MinIOObjectChunked -BucketName $testBucket -Files $testFile -ChunkSize 50MB -Verbose
-
- $endTime = Get-Date
- $duration = $endTime - $startTime
- $speedMBps = [math]::Round(($fileInfo.Length / 1MB) / $duration.TotalSeconds, 2)
-
- Write-Host ""
- Write-Host "SUCCESS: Chunked upload completed!" -ForegroundColor Green
- Write-Host "Duration: $($duration.ToString('hh\:mm\:ss'))" -ForegroundColor Gray
- Write-Host "Average speed: $speedMBps MB/s" -ForegroundColor Gray
- Write-Host ""
-
- $result | Format-Table ObjectName, BucketName, @{Name="SizeGB";Expression={[math]::Round($_.Size/1GB,2)}}
-
- # Test chunked download of first 100MB only (to save time)
- Write-Host "Testing partial chunked download (first 100MB)..." -ForegroundColor Yellow
-
- $downloadFile = "partial-download-test.wim"
-
- try {
- $downloadStartTime = Get-Date
-
- # Download with 10MB chunks
- $downloadResult = Get-MinIOObjectContentChunked -BucketName $testBucket -ObjectName $fileInfo.Name -FilePath $downloadFile -ChunkSize 10MB -Force -Verbose
-
- $downloadEndTime = Get-Date
- $downloadDuration = $downloadEndTime - $downloadStartTime
-
- Write-Host ""
- Write-Host "SUCCESS: Chunked download completed!" -ForegroundColor Green
- Write-Host "Duration: $($downloadDuration.ToString('hh\:mm\:ss'))" -ForegroundColor Gray
-
- # Check downloaded file size
- $downloadedFileInfo = Get-Item $downloadFile
- Write-Host "Downloaded: $([math]::Round($downloadedFileInfo.Length / 1GB, 2)) GB" -ForegroundColor Gray
-
- if ($downloadedFileInfo.Length -eq $fileInfo.Length) {
- Write-Host "SUCCESS: File size verification passed" -ForegroundColor Green
- } else {
- Write-Host "INFO: Partial download completed (expected for large files)" -ForegroundColor Yellow
- }
-
- # Cleanup downloaded file
- Remove-Item $downloadFile -Force -ErrorAction SilentlyContinue
-
- } catch {
- Write-Host "Download test failed: $($_.Exception.Message)" -ForegroundColor Red
- }
-
- # Cleanup uploaded file
- Write-Host ""
- Write-Host "Cleaning up uploaded file..." -ForegroundColor Yellow
- try {
- Remove-MinIOObject -BucketName $testBucket -ObjectName $fileInfo.Name -Force
- Write-Host "SUCCESS: Cleanup completed" -ForegroundColor Green
- } catch {
- Write-Host "WARNING: Cleanup failed - $($_.Exception.Message)" -ForegroundColor Yellow
- }
-
-} catch {
- Write-Host ""
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- if ($_.Exception.InnerException) {
- Write-Host "Inner Exception: $($_.Exception.InnerException.Message)" -ForegroundColor Red
- }
-}
-
-Write-Host ""
-Write-Host "=== Large File Test Complete ===" -ForegroundColor Cyan
diff --git a/Module/PSMinIO/bin/PSMinIO.dll b/Module/PSMinIO/bin/PSMinIO.dll
index 65c8da0..f4fe4f4 100644
Binary files a/Module/PSMinIO/bin/PSMinIO.dll and b/Module/PSMinIO/bin/PSMinIO.dll differ
diff --git a/Module/PSMinIO/bin/PSMinIO.pdb b/Module/PSMinIO/bin/PSMinIO.pdb
index 266d540..9c38678 100644
Binary files a/Module/PSMinIO/bin/PSMinIO.pdb and b/Module/PSMinIO/bin/PSMinIO.pdb differ
diff --git a/Quick-Test.ps1 b/Quick-Test.ps1
deleted file mode 100644
index 9e6f0b9..0000000
--- a/Quick-Test.ps1
+++ /dev/null
@@ -1,32 +0,0 @@
-# Quick test for PSMinIO module
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== Quick PSMinIO Test ===" -ForegroundColor Cyan
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-Write-Host "1. Connecting..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
- Write-Host "SUCCESS: Connected to $($connection.EndpointUrl)" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- exit 1
-}
-
-Write-Host "2. Testing bucket listing..." -ForegroundColor Yellow
-try {
- $buckets = Get-MinIOBucket
- Write-Host "SUCCESS: Found $($buckets.Count) buckets" -ForegroundColor Green
- if ($buckets.Count -gt 0) {
- $buckets | Format-Table Name, CreationDate
- }
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- Write-Host "Inner Exception: $($_.Exception.InnerException.Message)" -ForegroundColor Red
-}
-
-Write-Host "Test completed!" -ForegroundColor Cyan
diff --git a/README.md b/README.md
index 69b288e..05c1b54 100644
--- a/README.md
+++ b/README.md
@@ -1,71 +1,154 @@
# PSMinIO
-A fully-fledged C# PowerShell binary module built on top of the [Minio](https://www.nuget.org/packages/Minio) .NET SDK for managing MinIO object storage operations.
+A comprehensive PowerShell module for MinIO object storage operations, built on the official [Minio .NET SDK](https://www.nuget.org/packages/Minio). Provides full-featured object storage management with enterprise-grade capabilities.
## Features
-- **Cross-Platform Compatibility**: Built for .NET Standard 2.0, compatible with PowerShell 5.1+ and PowerShell 7+
-- **Comprehensive Bucket Operations**: Create, list, delete, and check bucket existence
-- **Object Management**: Upload, download, list, and delete objects with progress tracking
-- **Security & Policy Management**: Manage bucket policies and access controls
-- **Synchronous Operations**: All operations are synchronous for PowerShell compatibility
-- **Detailed Logging**: Centralized logging with timestamps when `-Verbose` is specified
-- **Progress Reporting**: Upload/download progress with percentages and time estimates
+- **🚀 High Performance**: Built for .NET Standard 2.0, compatible with PowerShell 5.1+ and PowerShell 7+
+- **📦 Complete Object Management**: Upload, download, list, and delete objects with advanced filtering and sorting
+- **🗂️ Flexible Directory Support**: Create nested folder structures with automatic directory creation
+- **⚡ Chunked Operations**: Large file uploads and downloads with resume capability and progress tracking
+- **🔒 Security & Policy Management**: Comprehensive bucket policy and access control management
+- **📊 Advanced Object Listing**: Filter by prefix, sort by multiple criteria, limit results, and exclude directories
+- **⏱️ Timing & Performance Metrics**: Detailed timing information and transfer speed reporting
+- **🔄 Progress Reporting**: Multi-layer progress tracking for file collections and chunked operations
+- **📝 Professional Logging**: Clean, timestamped logging with configurable verbosity levels
+- **🛡️ Robust Error Handling**: Graceful handling of network issues and edge cases
## Installation
+### From Source
```powershell
+# Clone the repository
+git clone https://github.com/yourusername/PSMinIO.git
+cd PSMinIO
+
+# Build the module
+dotnet build PSMinIO.csproj --configuration Release
+
# Import the module
-Import-Module .\PSMinIO.psd1
+Import-Module .\Module\PSMinIO\PSMinIO.psd1
+```
+
+### Direct Import
+```powershell
+# Import from local path
+Import-Module .\Module\PSMinIO\PSMinIO.psd1
```
## Quick Start
```powershell
-# Configure connection
-Set-MinIOConfig -Endpoint 'https://minio.myorg.com' -AccessKey 'AKIA...' -SecretKey 'abc123' -UseSSL
+# Connect to MinIO server
+$connection = Connect-MinIO -Endpoint "https://minio.example.com" -AccessKey "your-access-key" -SecretKey "your-secret-key"
# Create a bucket
-New-MinIOBucket -BucketName 'my-bucket' -Verbose
+New-MinIOBucket -BucketName 'my-data-bucket' -Verbose
-# Upload a file
-New-MinIOObject -BucketName 'my-bucket' -ObjectName 'data.txt' -FilePath 'C:\data.txt'
+# Upload files with automatic directory creation
+New-MinIOObject -BucketName 'my-data-bucket' -Files "document.pdf" -BucketDirectory "documents/2025/january"
-# List objects
-Get-MinIOObject -BucketName 'my-bucket' -Prefix '2025/'
+# List objects with advanced filtering
+Get-MinIOObject -BucketName 'my-data-bucket' -Prefix "documents/" -SortBy "Size" -Descending -MaxObjects 10
-# Download an object
-Get-MinIOObjectContent -BucketName 'my-bucket' -ObjectName 'data.txt' -FilePath 'C:\downloaded-data.txt'
+# Download with timing information
+Get-MinIOObjectContent -BucketName 'my-data-bucket' -ObjectName 'documents/2025/january/document.pdf' -FilePath 'C:\Downloads\document.pdf'
+
+# Chunked upload for large files
+New-MinIOObjectChunked -BucketName 'my-data-bucket' -Files "large-video.mp4" -ChunkSize 10MB -BucketDirectory "media/videos"
```
-## Cmdlets
+## Available Cmdlets
+
+### Connection Management
+- **`Connect-MinIO`** - Establish connection to MinIO server with SSL support and certificate validation options
### Bucket Operations
-- `Get-MinIOBucket` - Lists all buckets
-- `New-MinIOBucket` - Creates a new bucket
-- `Remove-MinIOBucket` - Deletes a bucket
-- `Test-MinIOBucketExists` - Checks if a bucket exists
+- **`Get-MinIOBucket`** - List all buckets with optional statistics
+- **`New-MinIOBucket`** - Create new buckets with region support
+- **`Remove-MinIOBucket`** - Delete buckets with safety confirmations
+- **`Test-MinIOBucketExists`** - Check bucket existence
### Object Operations
-- `Get-MinIOObject` - Lists objects in a bucket
-- `New-MinIOObject` - Uploads a file to a bucket
-- `Get-MinIOObjectContent` - Downloads an object
-- `Remove-MinIOObject` - Deletes an object
+- **`Get-MinIOObject`** - Advanced object listing with filtering, sorting, and pagination
+ - Filter by prefix or exact object name
+ - Sort by Name, Size, LastModified, or ETag (ascending/descending)
+ - Limit results with MaxObjects
+ - Exclude directories with ObjectsOnly
+- **`New-MinIOObject`** - Upload files with directory support
+ - Single file or multiple file uploads
+ - Automatic nested directory creation
+ - Progress tracking and timing information
+- **`New-MinIOObjectChunked`** - Chunked uploads for large files
+ - Configurable chunk sizes (1MB minimum)
+ - Resume capability and multi-layer progress tracking
+ - Automatic directory creation
+- **`Get-MinIOObjectContent`** - Download objects with progress tracking
+- **`Get-MinIOObjectContentChunked`** - Chunked downloads for large files
+- **`Remove-MinIOObject`** - Delete objects with confirmation prompts
+- **`New-MinIOFolder`** - Create folder structures in buckets
-### Security & Policy
-- `Get-MinIOBucketPolicy` - Retrieves bucket policy
-- `Set-MinIOBucketPolicy` - Sets bucket policy
+### Security & Policy Management
+- **`Get-MinIOBucketPolicy`** - Retrieve bucket access policies
+- **`Set-MinIOBucketPolicy`** - Configure bucket access policies
-### Utility
-- `Get-MinIOConfig` - Shows current configuration
-- `Set-MinIOConfig` - Sets connection configuration
-- `Get-MinIOStats` - Displays statistics and metrics
+### Monitoring & Statistics
+- **`Get-MinIOStats`** - Comprehensive server and bucket statistics with object counting limits
+
+## Key Features in Detail
+
+### 🗂️ Advanced Directory Support
+- **Nested Folder Creation**: Automatically create multi-level directory structures (e.g., `documents/2025/january/reports`)
+- **BucketDirectory Parameter**: Specify target directories for uploads without manual folder creation
+- **Clean Directory Handling**: Non-critical directory creation attempts with graceful fallback
+
+### ⚡ Chunked Operations
+- **Large File Support**: Handle files of any size with configurable chunk sizes
+- **Resume Capability**: Interrupted transfers can be resumed (future enhancement)
+- **Multi-Layer Progress**: Track collection progress, file progress, and chunk progress simultaneously
+- **Performance Optimization**: Optimal chunk sizes for different network conditions
+
+### 📊 Enhanced Object Listing
+```powershell
+# Advanced filtering and sorting examples
+Get-MinIOObject -BucketName "data" -Prefix "logs/" -SortBy "LastModified" -Descending -MaxObjects 50
+Get-MinIOObject -BucketName "media" -ObjectsOnly -SortBy "Size" -Descending
+Get-MinIOObject -BucketName "docs" -ObjectName "specific-file.pdf"
+```
+
+### ⏱️ Performance Metrics
+All operations provide detailed timing information:
+- **Duration**: Precise operation timing
+- **Transfer Speed**: Formatted speed reporting (B/s, KB/s, MB/s, GB/s, TB/s)
+- **Progress Tracking**: Real-time progress updates during transfers
+
+## Examples
+
+See the [examples](./examples/) directory for comprehensive usage examples:
+- **Basic Operations**: Connection, bucket management, simple uploads/downloads
+- **Advanced Scenarios**: Chunked transfers, directory management, bulk operations
+- **Enterprise Patterns**: Policy management, monitoring, and automation scripts
## Requirements
-- PowerShell 5.1+ or PowerShell 7+
-- .NET Framework 4.7.2+ (for PowerShell 5.1) or .NET Core/.NET 5+ (for PowerShell 7+)
+- **PowerShell**: 5.1+ or PowerShell 7+
+- **.NET Framework**: 4.7.2+ (for PowerShell 5.1) or .NET Core/.NET 5+ (for PowerShell 7+)
+- **MinIO Server**: Compatible with MinIO and Amazon S3 APIs
+
+## Contributing
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
## License
-This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
\ No newline at end of file
+This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- 📖 **Documentation**: See [docs/USAGE.md](docs/USAGE.md) for detailed usage instructions
+- 🐛 **Issues**: Report bugs and request features via GitHub Issues
+- 💬 **Discussions**: Join the community discussions for questions and tips
\ No newline at end of file
diff --git a/Session-Debug.ps1 b/Session-Debug.ps1
deleted file mode 100644
index 54fb022..0000000
--- a/Session-Debug.ps1
+++ /dev/null
@@ -1,40 +0,0 @@
-# Debug session variable issue
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== Session Variable Debug ===" -ForegroundColor Cyan
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-Write-Host "1. Before connection - checking variables..." -ForegroundColor Yellow
-Get-Variable -Name "*MinIO*" -Scope Global -ErrorAction SilentlyContinue | ForEach-Object {
- Write-Host "Found: $($_.Name) = $($_.Value)" -ForegroundColor Gray
-}
-
-Write-Host "2. Connecting..." -ForegroundColor Yellow
-$connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
-
-Write-Host "3. After connection - checking variables..." -ForegroundColor Yellow
-Get-Variable -Name "*MinIO*" -Scope Global -ErrorAction SilentlyContinue | ForEach-Object {
- Write-Host "Found: $($_.Name) = $($_.Value)" -ForegroundColor Gray
-}
-
-Write-Host "4. Checking specific variable..." -ForegroundColor Yellow
-try {
- $var = Get-Variable -Name "MinIOConnection" -Scope Global -ErrorAction Stop
- Write-Host "SUCCESS: Variable exists with value: $($var.Value)" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: Variable not found: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-Write-Host "5. Testing Get-MinIOBucket with verbose..." -ForegroundColor Yellow
-try {
- $buckets = Get-MinIOBucket -Verbose
- Write-Host "SUCCESS: Found $($buckets.Count) buckets" -ForegroundColor Green
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-Write-Host "Debug completed!" -ForegroundColor Cyan
diff --git a/Session-Test.ps1 b/Session-Test.ps1
deleted file mode 100644
index 7c64386..0000000
--- a/Session-Test.ps1
+++ /dev/null
@@ -1,48 +0,0 @@
-# Session variable test for PSMinIO module
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== Session Variable Test ===" -ForegroundColor Cyan
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-Write-Host "1. Before connection - checking existing variables..." -ForegroundColor Yellow
-Get-Variable -Name "*MinIO*" -ErrorAction SilentlyContinue | ForEach-Object {
- Write-Host "Found variable: $($_.Name) = $($_.Value)" -ForegroundColor Gray
-}
-
-Write-Host "2. Connecting with verbose output..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey -Verbose
- Write-Host "SUCCESS: Connected" -ForegroundColor Green
-
- Write-Host "3. After connection - checking variables..." -ForegroundColor Yellow
- Get-Variable -Name "*MinIO*" -ErrorAction SilentlyContinue | ForEach-Object {
- Write-Host "Found variable: $($_.Name) = $($_.Value)" -ForegroundColor Gray
- }
-
- # Try to manually set the session variable
- Write-Host "4. Manually setting session variable..." -ForegroundColor Yellow
- Set-Variable -Name "MinIOConnection" -Value $connection -Scope Global
-
- Write-Host "5. After manual set - checking variables..." -ForegroundColor Yellow
- Get-Variable -Name "*MinIO*" -ErrorAction SilentlyContinue | ForEach-Object {
- Write-Host "Found variable: $($_.Name) = $($_.Value)" -ForegroundColor Gray
- }
-
- # Now try Get-MinIOBucket without explicit connection
- Write-Host "6. Testing Get-MinIOBucket without explicit connection..." -ForegroundColor Yellow
- try {
- $buckets = Get-MinIOBucket -Verbose
- Write-Host "SUCCESS: Found $($buckets.Count) buckets" -ForegroundColor Green
- } catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- }
-
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-Write-Host "Session test completed!" -ForegroundColor Cyan
diff --git a/Simple-Chunked-Test.ps1 b/Simple-Chunked-Test.ps1
deleted file mode 100644
index 29fa95b..0000000
--- a/Simple-Chunked-Test.ps1
+++ /dev/null
@@ -1,48 +0,0 @@
-# Simple chunked upload test
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== Simple Chunked Test ===" -ForegroundColor Cyan
-
-# Test file
-$testFile = "C:\Users\gsadmin\Downloads\windows_10_enterprise_ltsc_2021_x64\sources\install.wim"
-
-# Check file
-if (Test-Path $testFile) {
- $fileInfo = Get-Item $testFile
- Write-Host "File found: $($fileInfo.Name)" -ForegroundColor Green
- Write-Host "Size: $([math]::Round($fileInfo.Length / 1GB, 2)) GB" -ForegroundColor Yellow
-} else {
- Write-Host "File not found!" -ForegroundColor Red
- exit 1
-}
-
-# Connect
-Write-Host "Connecting..." -ForegroundColor Yellow
-$connection = Connect-MinIO -Endpoint "https://api.s3.gracesolution.info" -AccessKey "T34Wg85SAwezUa3sk3m4" -SecretKey "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-# Get bucket
-$buckets = Get-MinIOBucket
-$testBucket = $buckets[0].Name
-Write-Host "Using bucket: $testBucket" -ForegroundColor Yellow
-
-# Test chunked upload with 50MB chunks
-Write-Host "Starting chunked upload with 50MB chunks..." -ForegroundColor Yellow
-try {
- $startTime = Get-Date
- $result = New-MinIOObjectChunked -BucketName $testBucket -Files $testFile -ChunkSize 50MB -Verbose
- $endTime = Get-Date
-
- $duration = $endTime - $startTime
- $speedMBps = [math]::Round(($fileInfo.Length / 1MB) / $duration.TotalSeconds, 2)
-
- Write-Host "SUCCESS!" -ForegroundColor Green
- Write-Host "Duration: $($duration.ToString('hh\:mm\:ss'))" -ForegroundColor Gray
- Write-Host "Speed: $speedMBps MB/s" -ForegroundColor Gray
-
- $result | Format-Table ObjectName, BucketName, @{Name="SizeGB";Expression={[math]::Round($_.Size/1GB,2)}}
-
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-Write-Host "Test completed!" -ForegroundColor Cyan
diff --git a/Simple-Test.ps1 b/Simple-Test.ps1
deleted file mode 100644
index 3851e97..0000000
--- a/Simple-Test.ps1
+++ /dev/null
@@ -1,34 +0,0 @@
-# Simple test script for PSMinIO module
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== Testing PSMinIO Module ===" -ForegroundColor Cyan
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-# Test 1: Connection
-Write-Host "1. Testing Connection..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
- Write-Host "✓ Connection successful" -ForegroundColor Green
- Write-Host " Endpoint: $($connection.EndpointUrl)" -ForegroundColor Gray
-} catch {
- Write-Host "✗ Connection failed: $($_.Exception.Message)" -ForegroundColor Red
- exit 1
-}
-
-# Test 2: Bucket Listing
-Write-Host "2. Testing Bucket Listing..." -ForegroundColor Yellow
-try {
- $buckets = Get-MinIOBucket
- Write-Host "✓ Found $($buckets.Count) buckets" -ForegroundColor Green
- if ($buckets.Count -gt 0) {
- $buckets | Select-Object -First 3 | Format-Table Name, CreationDate
- }
-} catch {
- Write-Host "✗ Bucket listing failed: $($_.Exception.Message)" -ForegroundColor Red
-}
-
-Write-Host "Tests completed!" -ForegroundColor Cyan
diff --git a/Test-PSMinIO.ps1 b/Test-PSMinIO.ps1
deleted file mode 100644
index acf92d7..0000000
--- a/Test-PSMinIO.ps1
+++ /dev/null
@@ -1,107 +0,0 @@
-# Test script for PSMinIO module
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== Testing PSMinIO Module ===" -ForegroundColor Cyan
-Write-Host ""
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-# Test 1: Connection
-Write-Host "1. Testing Connection..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey -TestConnection
- Write-Host "✓ Connection successful" -ForegroundColor Green
- Write-Host " Endpoint: $($connection.EndpointUrl)" -ForegroundColor Gray
-} catch {
- Write-Host "✗ Connection failed: $($_.Exception.Message)" -ForegroundColor Red
- exit 1
-}
-Write-Host ""
-
-# Test 2: Bucket Listing
-Write-Host "2. Testing Bucket Listing..." -ForegroundColor Yellow
-try {
- $buckets = Get-MinIOBucket
- Write-Host "✓ Found $($buckets.Count) buckets" -ForegroundColor Green
- if ($buckets.Count -gt 0) {
- $buckets | Select-Object -First 3 | Format-Table Name, CreationDate, @{Name="Size";Expression={$_.SizeFormatted}}
- }
-} catch {
- Write-Host "✗ Bucket listing failed: $($_.Exception.Message)" -ForegroundColor Red
-}
-Write-Host ""
-
-# Test 3: Create test file for upload
-Write-Host "3. Creating test file..." -ForegroundColor Yellow
-$testFile = "test-upload.txt"
-$testContent = "This is a test file created at $(Get-Date) for PSMinIO testing."
-Set-Content -Path $testFile -Value $testContent
-Write-Host "✓ Created test file: $testFile" -ForegroundColor Green
-Write-Host ""
-
-# Test 4: File Upload (if we have buckets)
-if ($buckets -and $buckets.Count -gt 0) {
- $testBucket = $buckets[0].Name
- Write-Host "4. Testing File Upload to bucket '$testBucket'..." -ForegroundColor Yellow
- try {
- $uploadResult = New-MinIOObject -BucketName $testBucket -Files $testFile
- Write-Host "✓ File upload successful" -ForegroundColor Green
- $uploadResult | Format-Table ObjectName, BucketName, Size
- } catch {
- Write-Host "✗ File upload failed: $($_.Exception.Message)" -ForegroundColor Red
- }
- Write-Host ""
-
- # Test 5: File Download
- Write-Host "5. Testing File Download..." -ForegroundColor Yellow
- $downloadFile = "downloaded-test.txt"
- try {
- $downloadResult = Get-MinIOObjectContent -BucketName $testBucket -ObjectName $testFile -FilePath $downloadFile -Force
- Write-Host "✓ File download successful" -ForegroundColor Green
- Write-Host " Downloaded to: $($downloadResult.FullName)" -ForegroundColor Gray
- Write-Host " Content: $(Get-Content $downloadFile)" -ForegroundColor Gray
- } catch {
- Write-Host "✗ File download failed: $($_.Exception.Message)" -ForegroundColor Red
- }
- Write-Host ""
-
- # Test 6: Chunked Upload
- Write-Host "6. Testing Chunked Upload..." -ForegroundColor Yellow
- $chunkedFile = "chunked-test.txt"
- $chunkedContent = ("This is a chunked upload test file created at $(Get-Date).`n") * 100
- Set-Content -Path $chunkedFile -Value $chunkedContent
- try {
- $chunkedResult = New-MinIOObjectChunked -BucketName $testBucket -Files $chunkedFile -ChunkSize 1KB
- Write-Host "✓ Chunked upload successful" -ForegroundColor Green
- $chunkedResult | Format-Table ObjectName, BucketName, Size
- } catch {
- Write-Host "✗ Chunked upload failed: $($_.Exception.Message)" -ForegroundColor Red
- }
- Write-Host ""
-
- # Test 7: Chunked Download
- Write-Host "7. Testing Chunked Download..." -ForegroundColor Yellow
- $chunkedDownload = "chunked-downloaded.txt"
- try {
- $chunkedDownloadResult = Get-MinIOObjectContentChunked -BucketName $testBucket -ObjectName $chunkedFile -FilePath $chunkedDownload -ChunkSize 1KB -Force
- Write-Host "✓ Chunked download successful" -ForegroundColor Green
- Write-Host " Downloaded to: $($chunkedDownloadResult.FullName)" -ForegroundColor Gray
- } catch {
- Write-Host "✗ Chunked download failed: $($_.Exception.Message)" -ForegroundColor Red
- }
-} else {
- Write-Host "4-7. Skipping upload/download tests - no buckets available" -ForegroundColor Yellow
-}
-
-Write-Host ""
-Write-Host "=== Test Summary ===" -ForegroundColor Cyan
-Write-Host "All tests completed. Check results above." -ForegroundColor White
-
-# Cleanup
-if (Test-Path $testFile) { Remove-Item $testFile -Force }
-if (Test-Path $downloadFile) { Remove-Item $downloadFile -Force }
-if (Test-Path $chunkedFile) { Remove-Item $chunkedFile -Force }
-if (Test-Path $chunkedDownload) { Remove-Item $chunkedDownload -Force }
diff --git a/Verbose-Test.ps1 b/Verbose-Test.ps1
deleted file mode 100644
index 6a91896..0000000
--- a/Verbose-Test.ps1
+++ /dev/null
@@ -1,27 +0,0 @@
-# Verbose test for PSMinIO module
-Import-Module ./Module/PSMinIO/PSMinIO.psd1 -Force
-
-Write-Host "=== Verbose PSMinIO Test ===" -ForegroundColor Cyan
-
-# Test credentials
-$endpoint = "https://api.s3.gracesolution.info"
-$accessKey = "T34Wg85SAwezUa3sk3m4"
-$secretKey = "PxEmnbQoQJTJsDocSEV6mSSscDpJMiJCayPv93xe"
-
-Write-Host "1. Connecting with verbose..." -ForegroundColor Yellow
-try {
- $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey -Verbose
- Write-Host "SUCCESS: Connected to $($connection.EndpointUrl)" -ForegroundColor Green
-
- Write-Host "2. Testing bucket listing with verbose..." -ForegroundColor Yellow
- $buckets = Get-MinIOBucket -Verbose
- Write-Host "SUCCESS: Found $($buckets.Count) buckets" -ForegroundColor Green
- if ($buckets.Count -gt 0) {
- $buckets | Format-Table Name, CreationDate
- }
-} catch {
- Write-Host "FAILED: $($_.Exception.Message)" -ForegroundColor Red
- Write-Host "Inner Exception: $($_.Exception.InnerException.Message)" -ForegroundColor Red
-}
-
-Write-Host "Test completed!" -ForegroundColor Cyan
diff --git a/docs/USAGE.md b/docs/USAGE.md
index 4570462..fd17178 100644
--- a/docs/USAGE.md
+++ b/docs/USAGE.md
@@ -1,16 +1,19 @@
# PSMinIO Usage Guide
-This guide provides comprehensive examples and usage patterns for the PSMinIO PowerShell module.
+This comprehensive guide covers all aspects of using the PSMinIO PowerShell module for MinIO object storage operations.
## Table of Contents
- [Installation](#installation)
-- [Configuration](#configuration)
+- [Connection Management](#connection-management)
- [Bucket Operations](#bucket-operations)
- [Object Operations](#object-operations)
+- [Advanced Object Listing](#advanced-object-listing)
+- [Directory and Folder Management](#directory-and-folder-management)
+- [Chunked Operations](#chunked-operations)
- [Security and Policies](#security-and-policies)
-- [Statistics and Monitoring](#statistics-and-monitoring)
-- [Advanced Usage](#advanced-usage)
+- [Performance and Monitoring](#performance-and-monitoring)
+- [Advanced Usage Patterns](#advanced-usage-patterns)
- [Troubleshooting](#troubleshooting)
## Installation
@@ -23,29 +26,39 @@ This guide provides comprehensive examples and usage patterns for the PSMinIO Po
### Import the Module
```powershell
-# Import the module
-Import-Module .\PSMinIO.psd1
+# Import the module from the Module directory
+Import-Module .\Module\PSMinIO\PSMinIO.psd1
-# Verify the module is loaded
+# Verify the module is loaded and check available cmdlets
Get-Module PSMinIO
+Get-Command -Module PSMinIO
```
-## Configuration
+## Connection Management
-### Basic Configuration
+### Establishing Connections
+
+PSMinIO uses a modern connection-based approach with the `Connect-MinIO` cmdlet:
```powershell
-# Set up MinIO connection
-Set-MinIOConfig -Endpoint "minio.example.com:9000" `
- -AccessKey "your-access-key" `
- -SecretKey "your-secret-key" `
- -UseSSL
+# Connect to MinIO server with SSL
+$connection = Connect-MinIO -Endpoint "https://minio.example.com" -AccessKey "your-access-key" -SecretKey "your-secret-key"
-# For local development (no SSL)
-Set-MinIOConfig -Endpoint "localhost:9000" `
- -AccessKey "minioadmin" `
- -SecretKey "minioadmin" `
- -NoSSL
+# Connect to local MinIO (no SSL)
+$connection = Connect-MinIO -Endpoint "http://localhost:9000" -AccessKey "minioadmin" -SecretKey "minioadmin"
+
+# Connect with custom port
+$connection = Connect-MinIO -Endpoint "https://minio.example.com:9443" -AccessKey "your-access-key" -SecretKey "your-secret-key"
+```
+
+### Connection Options
+
+```powershell
+# Skip SSL certificate validation (for self-signed certificates)
+$connection = Connect-MinIO -Endpoint "https://minio.internal.com" -AccessKey "key" -SecretKey "secret" -SkipCertificateValidation
+
+# Connection with region specification
+$connection = Connect-MinIO -Endpoint "https://s3.amazonaws.com" -AccessKey "key" -SecretKey "secret" -Region "us-west-2"
```
### Advanced Configuration
@@ -220,6 +233,158 @@ Remove-MinIOObject -BucketName "cache" `
-Force
```
+## Advanced Object Listing
+
+The `Get-MinIOObject` cmdlet provides powerful filtering, sorting, and pagination capabilities:
+
+### Basic Object Listing
+
+```powershell
+# List all objects in a bucket
+Get-MinIOObject -BucketName "my-bucket"
+
+# List objects with a specific prefix
+Get-MinIOObject -BucketName "my-bucket" -Prefix "documents/"
+
+# List objects recursively (default behavior)
+Get-MinIOObject -BucketName "my-bucket" -Prefix "logs/" -Recursive
+
+# List objects non-recursively (current level only)
+Get-MinIOObject -BucketName "my-bucket" -Prefix "logs/" -Recursive:$false
+```
+
+### Advanced Filtering
+
+```powershell
+# Get a specific object by exact name
+Get-MinIOObject -BucketName "my-bucket" -ObjectName "documents/report.pdf"
+
+# List only files (exclude directory markers)
+Get-MinIOObject -BucketName "my-bucket" -ObjectsOnly
+
+# Include object versions (for versioned buckets)
+Get-MinIOObject -BucketName "my-bucket" -IncludeVersions
+
+# Limit the number of results
+Get-MinIOObject -BucketName "my-bucket" -MaxObjects 50
+```
+
+### Sorting Options
+
+```powershell
+# Sort by name (ascending - default)
+Get-MinIOObject -BucketName "my-bucket" -SortBy "Name"
+
+# Sort by name (descending)
+Get-MinIOObject -BucketName "my-bucket" -SortBy "Name" -Descending
+
+# Sort by file size (largest first)
+Get-MinIOObject -BucketName "my-bucket" -SortBy "Size" -Descending
+
+# Sort by last modified date (newest first)
+Get-MinIOObject -BucketName "my-bucket" -SortBy "LastModified" -Descending
+
+# Sort by ETag
+Get-MinIOObject -BucketName "my-bucket" -SortBy "ETag"
+```
+
+### Complex Queries
+
+```powershell
+# Find large files in a specific directory
+Get-MinIOObject -BucketName "media" -Prefix "videos/" -SortBy "Size" -Descending -MaxObjects 10
+
+# Get recent files only
+$recentFiles = Get-MinIOObject -BucketName "logs" -SortBy "LastModified" -Descending -MaxObjects 20
+
+# Find files by pattern using PowerShell filtering
+Get-MinIOObject -BucketName "documents" | Where-Object { $_.Name -like "*.pdf" -and $_.Size -gt 1MB }
+
+# Get directory structure overview
+Get-MinIOObject -BucketName "my-bucket" | Group-Object { ($_.Name -split '/')[0] } | Format-Table Name, Count
+```
+
+## Directory and Folder Management
+
+### Creating Directory Structures
+
+```powershell
+# Create explicit folder structures
+New-MinIOFolder -BucketName "my-bucket" -FolderName "projects/web-app/src"
+New-MinIOFolder -BucketName "my-bucket" -FolderName "projects/web-app/docs"
+
+# Create multiple folder levels at once
+New-MinIOFolder -BucketName "my-bucket" -FolderName "company/departments/engineering/teams/backend"
+```
+
+### Automatic Directory Creation
+
+```powershell
+# Upload files with automatic directory creation using BucketDirectory
+New-MinIOObject -BucketName "my-bucket" -Files "report.pdf" -BucketDirectory "documents/2025/january"
+
+# Create nested directory structures automatically
+New-MinIOObject -BucketName "my-bucket" -Files "config.json" -BucketDirectory "projects/web-app/config/production"
+```
+
+### Directory-Based Operations
+
+```powershell
+# List all directories (folder markers)
+Get-MinIOObject -BucketName "my-bucket" | Where-Object { $_.IsDirectory }
+
+# List files in a specific directory
+Get-MinIOObject -BucketName "my-bucket" -Prefix "documents/2025/" -ObjectsOnly
+
+# Organize files by date-based directories
+$today = Get-Date -Format "yyyy/MM/dd"
+New-MinIOObject -BucketName "logs" -Files "app.log" -BucketDirectory "daily-logs/$today"
+```
+
+## Chunked Operations
+
+### Chunked Uploads
+
+```powershell
+# Upload large files with chunked transfer
+New-MinIOObjectChunked -BucketName "media" -Files "large-video.mp4" -ChunkSize 10MB
+
+# Upload with custom chunk size and directory
+New-MinIOObjectChunked -BucketName "backups" -Files "database-backup.sql" -ChunkSize 5MB -BucketDirectory "daily-backups/$(Get-Date -Format 'yyyy-MM-dd')"
+
+# Upload multiple large files
+New-MinIOObjectChunked -BucketName "media" -Files @("video1.mp4", "video2.mp4") -ChunkSize 10MB -BucketDirectory "videos/uploads"
+```
+
+### Chunked Downloads
+
+```powershell
+# Download large files with chunked transfer
+Get-MinIOObjectContentChunked -BucketName "media" -ObjectName "large-video.mp4" -FilePath "C:\Downloads\video.mp4" -ChunkSize 10MB
+
+# Download with progress tracking
+Get-MinIOObjectContentChunked -BucketName "backups" -ObjectName "large-backup.zip" -FilePath "C:\Restore\backup.zip" -ChunkSize 5MB
+```
+
+### Chunk Size Guidelines
+
+```powershell
+# Recommended chunk sizes based on file size:
+# Files < 10MB: Use regular upload/download
+# Files 10MB - 100MB: Use 1-5MB chunks
+# Files 100MB - 1GB: Use 5-10MB chunks
+# Files > 1GB: Use 10-50MB chunks
+
+# Example with optimal chunk size selection
+$fileSize = (Get-Item "large-file.zip").Length
+$chunkSize = if ($fileSize -lt 10MB) { 1MB }
+ elseif ($fileSize -lt 100MB) { 5MB }
+ elseif ($fileSize -lt 1GB) { 10MB }
+ else { 25MB }
+
+New-MinIOObjectChunked -BucketName "uploads" -Files "large-file.zip" -ChunkSize $chunkSize
+```
+
## Security and Policies
### Get Bucket Policies
diff --git a/examples/01-Basic-Operations.ps1 b/examples/01-Basic-Operations.ps1
new file mode 100644
index 0000000..0953e36
--- /dev/null
+++ b/examples/01-Basic-Operations.ps1
@@ -0,0 +1,71 @@
+# PSMinIO Basic Operations Example
+# This script demonstrates fundamental MinIO operations using PSMinIO
+
+# Import the module
+Import-Module ..\Module\PSMinIO\PSMinIO.psd1
+
+# Example connection details (replace with your actual values)
+$endpoint = "https://minio.example.com"
+$accessKey = "your-access-key"
+$secretKey = "your-secret-key"
+
+try {
+ # Connect to MinIO server
+ $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
+ "Connected to MinIO server: $endpoint"
+
+ # List all buckets
+ "Listing all buckets..."
+ $buckets = Get-MinIOBucket
+ $buckets | Format-Table Name, CreationDate, @{Name="Objects";Expression={"N/A"}}
+
+ # Create a new bucket
+ $bucketName = "example-bucket-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+ "Creating bucket: $bucketName"
+ New-MinIOBucket -BucketName $bucketName
+
+ # Verify bucket creation
+ if (Test-MinIOBucketExists -BucketName $bucketName) {
+ "✅ Bucket '$bucketName' created successfully"
+ }
+
+ # Create a sample file for upload
+ $sampleFile = "sample-document.txt"
+ "This is a sample document created on $(Get-Date)" | Out-File -FilePath $sampleFile -Encoding UTF8
+
+ # Upload the file
+ "Uploading file: $sampleFile"
+ $uploadResult = New-MinIOObject -BucketName $bucketName -Files $sampleFile
+ $uploadResult | Format-Table Name, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+
+ # List objects in the bucket
+ "Listing objects in bucket '$bucketName':"
+ $objects = Get-MinIOObject -BucketName $bucketName
+ $objects | Format-Table Name, @{Name="Size";Expression={"$($_.Size) bytes"}}, LastModified
+
+ # Download the file
+ $downloadPath = "downloaded-$sampleFile"
+ "Downloading file to: $downloadPath"
+ $downloadResult = Get-MinIOObjectContent -BucketName $bucketName -ObjectName $sampleFile -FilePath $downloadPath
+ $downloadResult | Format-Table @{Name="LocalFile";Expression={$_.FilePath.Name}}, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+
+ # Verify download
+ if (Test-Path $downloadPath) {
+ "✅ File downloaded successfully"
+ "Content: $(Get-Content $downloadPath)"
+ }
+
+ # Clean up
+ "Cleaning up..."
+ Remove-MinIOObject -BucketName $bucketName -ObjectName $sampleFile -Force
+ Remove-MinIOBucket -BucketName $bucketName -Force
+ Remove-Item $sampleFile, $downloadPath -Force -ErrorAction SilentlyContinue
+
+ "✅ Basic operations completed successfully"
+
+} catch {
+ "❌ Error: $($_.Exception.Message)"
+} finally {
+ # Clean up any remaining files
+ Remove-Item "sample-document.txt", "downloaded-sample-document.txt" -Force -ErrorAction SilentlyContinue
+}
diff --git a/examples/02-Advanced-Object-Listing.ps1 b/examples/02-Advanced-Object-Listing.ps1
new file mode 100644
index 0000000..a86aac3
--- /dev/null
+++ b/examples/02-Advanced-Object-Listing.ps1
@@ -0,0 +1,108 @@
+# PSMinIO Advanced Object Listing Example
+# Demonstrates the powerful Get-MinIOObject cmdlet with filtering, sorting, and pagination
+
+# Import the module
+Import-Module ..\Module\PSMinIO\PSMinIO.psd1
+
+# Connection details (replace with your actual values)
+$endpoint = "https://minio.example.com"
+$accessKey = "your-access-key"
+$secretKey = "your-secret-key"
+
+try {
+ # Connect to MinIO
+ $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
+ "Connected to MinIO server for advanced object listing demo"
+
+ # Create a demo bucket
+ $bucketName = "demo-listing-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+ New-MinIOBucket -BucketName $bucketName
+ "Created demo bucket: $bucketName"
+
+ # Create sample files with different sizes and organize them in directories
+ "Creating sample files..."
+
+ # Documents directory
+ "Small document content" | Out-File -FilePath "small-doc.txt" -Encoding UTF8
+ "Medium document content " * 50 | Out-File -FilePath "medium-doc.txt" -Encoding UTF8
+ "Large document content " * 200 | Out-File -FilePath "large-doc.txt" -Encoding UTF8
+
+ # Images directory (simulated)
+ "Image data " * 100 | Out-File -FilePath "image1.jpg" -Encoding UTF8
+ "Image data " * 300 | Out-File -FilePath "image2.png" -Encoding UTF8
+
+ # Logs directory
+ "Log entry " * 20 | Out-File -FilePath "app.log" -Encoding UTF8
+ "Error log " * 80 | Out-File -FilePath "error.log" -Encoding UTF8
+
+ # Upload files to different directories
+ New-MinIOObject -BucketName $bucketName -Files "small-doc.txt" -BucketDirectory "documents/2025"
+ New-MinIOObject -BucketName $bucketName -Files "medium-doc.txt" -BucketDirectory "documents/2025"
+ New-MinIOObject -BucketName $bucketName -Files "large-doc.txt" -BucketDirectory "documents/archive"
+ New-MinIOObject -BucketName $bucketName -Files "image1.jpg" -BucketDirectory "media/images"
+ New-MinIOObject -BucketName $bucketName -Files "image2.png" -BucketDirectory "media/images"
+ New-MinIOObject -BucketName $bucketName -Files "app.log" -BucketDirectory "logs/application"
+ New-MinIOObject -BucketName $bucketName -Files "error.log" -BucketDirectory "logs/system"
+
+ "Sample files uploaded to various directories"
+ ""
+
+ # Demonstrate different listing capabilities
+ "=== 1. List All Objects ==="
+ $allObjects = Get-MinIOObject -BucketName $bucketName
+ $allObjects | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+ ""
+
+ "=== 2. Filter by Prefix ==="
+ $documentsObjects = Get-MinIOObject -BucketName $bucketName -Prefix "documents/"
+ $documentsObjects | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+ ""
+
+ "=== 3. Sort by Size (Descending) ==="
+ $sortedBySize = Get-MinIOObject -BucketName $bucketName -SortBy "Size" -Descending
+ $sortedBySize | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+ ""
+
+ "=== 4. Sort by Name (Ascending) ==="
+ $sortedByName = Get-MinIOObject -BucketName $bucketName -SortBy "Name"
+ $sortedByName | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+ ""
+
+ "=== 5. Limit Results ==="
+ $limitedResults = Get-MinIOObject -BucketName $bucketName -MaxObjects 3 -SortBy "Size" -Descending
+ $limitedResults | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+ ""
+
+ "=== 6. Files Only (Exclude Directories) ==="
+ $filesOnly = Get-MinIOObject -BucketName $bucketName -ObjectsOnly
+ $filesOnly | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+ ""
+
+ "=== 7. Specific Object Lookup ==="
+ $specificObject = Get-MinIOObject -BucketName $bucketName -ObjectName "documents/2025/small-doc.txt"
+ if ($specificObject) {
+ $specificObject | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+ } else {
+ "Object not found"
+ }
+ ""
+
+ "=== 8. Complex Filtering Example ==="
+ "Large files in media directory:"
+ $largeMediaFiles = Get-MinIOObject -BucketName $bucketName -Prefix "media/" -SortBy "Size" -Descending | Where-Object { $_.Size -gt 1000 }
+ $largeMediaFiles | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+
+ # Clean up
+ "Cleaning up demo files..."
+ $allObjects = Get-MinIOObject -BucketName $bucketName
+ foreach ($obj in $allObjects) {
+ Remove-MinIOObject -BucketName $bucketName -ObjectName $obj.Name -Force
+ }
+ Remove-MinIOBucket -BucketName $bucketName -Force
+ Remove-Item "small-doc.txt", "medium-doc.txt", "large-doc.txt", "image1.jpg", "image2.png", "app.log", "error.log" -Force -ErrorAction SilentlyContinue
+
+ "✅ Advanced object listing demo completed"
+
+} catch {
+ "❌ Error: $($_.Exception.Message)"
+}
diff --git a/examples/03-Directory-Management.ps1 b/examples/03-Directory-Management.ps1
new file mode 100644
index 0000000..34bd147
--- /dev/null
+++ b/examples/03-Directory-Management.ps1
@@ -0,0 +1,135 @@
+# PSMinIO Directory and Folder Management Example
+# Demonstrates creating nested directory structures and organizing files
+
+# Import the module
+Import-Module ..\Module\PSMinIO\PSMinIO.psd1
+
+# Connection details (replace with your actual values)
+$endpoint = "https://minio.example.com"
+$accessKey = "your-access-key"
+$secretKey = "your-secret-key"
+
+try {
+ # Connect to MinIO
+ $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
+ "Connected to MinIO server for directory management demo"
+
+ # Create a demo bucket
+ $bucketName = "directory-demo-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+ New-MinIOBucket -BucketName $bucketName
+ "Created demo bucket: $bucketName"
+
+ # Create sample files for different scenarios
+ "Creating sample files..."
+ "Project documentation" | Out-File -FilePath "README.md" -Encoding UTF8
+ "Configuration settings" | Out-File -FilePath "config.json" -Encoding UTF8
+ "Application source code" | Out-File -FilePath "app.py" -Encoding UTF8
+ "Test data" | Out-File -FilePath "test-data.csv" -Encoding UTF8
+ "Build output" | Out-File -FilePath "app.exe" -Encoding UTF8
+
+ "=== 1. Creating Explicit Folder Structures ==="
+ # Create explicit folder structures using New-MinIOFolder
+ New-MinIOFolder -BucketName $bucketName -FolderName "projects/web-app/src"
+ New-MinIOFolder -BucketName $bucketName -FolderName "projects/web-app/tests"
+ New-MinIOFolder -BucketName $bucketName -FolderName "projects/web-app/docs"
+ New-MinIOFolder -BucketName $bucketName -FolderName "projects/api/v1"
+ New-MinIOFolder -BucketName $bucketName -FolderName "projects/api/v2"
+ "Created explicit folder structures"
+ ""
+
+ "=== 2. Automatic Directory Creation with BucketDirectory ==="
+ # Upload files with automatic directory creation
+ New-MinIOObject -BucketName $bucketName -Files "README.md" -BucketDirectory "projects/web-app/docs"
+ New-MinIOObject -BucketName $bucketName -Files "config.json" -BucketDirectory "projects/web-app/config"
+ New-MinIOObject -BucketName $bucketName -Files "app.py" -BucketDirectory "projects/web-app/src"
+ New-MinIOObject -BucketName $bucketName -Files "test-data.csv" -BucketDirectory "projects/web-app/tests/data"
+ New-MinIOObject -BucketName $bucketName -Files "app.exe" -BucketDirectory "releases/v1.0/binaries"
+ "Uploaded files with automatic directory creation"
+ ""
+
+ "=== 3. Multi-Level Directory Structure ==="
+ # Create a complex directory structure
+ $complexStructure = @(
+ "company/departments/engineering/teams/backend",
+ "company/departments/engineering/teams/frontend",
+ "company/departments/engineering/teams/devops",
+ "company/departments/marketing/campaigns/2025",
+ "company/departments/hr/policies/remote-work"
+ )
+
+ foreach ($folder in $complexStructure) {
+ New-MinIOFolder -BucketName $bucketName -FolderName $folder
+ }
+ "Created complex multi-level directory structure"
+ ""
+
+ "=== 4. Viewing Directory Structure ==="
+ # List all objects to see the directory structure
+ $allObjects = Get-MinIOObject -BucketName $bucketName
+ "Complete directory and file structure:"
+ $allObjects | Sort-Object Name | Format-Table Name, @{Name="Type";Expression={if($_.IsDirectory){"Directory"}else{"File"}}}, @{Name="Size";Expression={if($_.IsDirectory){"-"}else{"$($_.Size) B"}}} -AutoSize
+ ""
+
+ "=== 5. Filtering by Directory ==="
+ # Show objects in specific directories
+ "Files in projects/web-app/:"
+ $webAppFiles = Get-MinIOObject -BucketName $bucketName -Prefix "projects/web-app/"
+ $webAppFiles | Format-Table Name, @{Name="Type";Expression={if($_.IsDirectory){"Directory"}else{"File"}}}, @{Name="Size";Expression={if($_.IsDirectory){"-"}else{"$($_.Size) B"}}} -AutoSize
+ ""
+
+ "Engineering team directories:"
+ $engineeringDirs = Get-MinIOObject -BucketName $bucketName -Prefix "company/departments/engineering/teams/"
+ $engineeringDirs | Format-Table Name, @{Name="Type";Expression={if($_.IsDirectory){"Directory"}else{"File"}}} -AutoSize
+ ""
+
+ "=== 6. Directory-Only Listing ==="
+ # Show only directories (folders)
+ $directoriesOnly = Get-MinIOObject -BucketName $bucketName | Where-Object { $_.IsDirectory }
+ "Directories only:"
+ $directoriesOnly | Sort-Object Name | Format-Table Name -AutoSize
+ ""
+
+ "=== 7. Files-Only Listing ==="
+ # Show only files (excluding directories)
+ $filesOnly = Get-MinIOObject -BucketName $bucketName -ObjectsOnly
+ "Files only:"
+ $filesOnly | Format-Table Name, @{Name="Size";Expression={"$($_.Size) B"}}, LastModified -AutoSize
+ ""
+
+ "=== 8. Organizing Files by Date ==="
+ # Create date-based directory structure
+ $currentDate = Get-Date
+ $yearMonth = $currentDate.ToString("yyyy/MM")
+ $dailyFolder = $currentDate.ToString("yyyy/MM/dd")
+
+ # Upload files to date-based directories
+ "Sample log entry" | Out-File -FilePath "daily.log" -Encoding UTF8
+ "Backup data" | Out-File -FilePath "backup.zip" -Encoding UTF8
+
+ New-MinIOObject -BucketName $bucketName -Files "daily.log" -BucketDirectory "logs/$dailyFolder"
+ New-MinIOObject -BucketName $bucketName -Files "backup.zip" -BucketDirectory "backups/$yearMonth"
+
+ "Created date-based directory structure and uploaded files"
+ ""
+
+ # Show the final structure
+ "=== Final Directory Structure ==="
+ $finalStructure = Get-MinIOObject -BucketName $bucketName | Sort-Object Name
+ $finalStructure | Format-Table Name, @{Name="Type";Expression={if($_.IsDirectory){"Directory"}else{"File"}}}, @{Name="Size";Expression={if($_.IsDirectory){"-"}else{"$($_.Size) B"}}} -AutoSize
+
+ # Clean up
+ "Cleaning up demo files..."
+ $allObjects = Get-MinIOObject -BucketName $bucketName
+ foreach ($obj in $allObjects) {
+ if (-not $obj.IsDirectory) {
+ Remove-MinIOObject -BucketName $bucketName -ObjectName $obj.Name -Force
+ }
+ }
+ Remove-MinIOBucket -BucketName $bucketName -Force
+ Remove-Item "README.md", "config.json", "app.py", "test-data.csv", "app.exe", "daily.log", "backup.zip" -Force -ErrorAction SilentlyContinue
+
+ "✅ Directory management demo completed"
+
+} catch {
+ "❌ Error: $($_.Exception.Message)"
+}
diff --git a/examples/04-Chunked-Operations.ps1 b/examples/04-Chunked-Operations.ps1
new file mode 100644
index 0000000..5cd607b
--- /dev/null
+++ b/examples/04-Chunked-Operations.ps1
@@ -0,0 +1,153 @@
+# PSMinIO Chunked Operations Example
+# Demonstrates chunked uploads and downloads for large files with progress tracking
+
+# Import the module
+Import-Module ..\Module\PSMinIO\PSMinIO.psd1
+
+# Connection details (replace with your actual values)
+$endpoint = "https://minio.example.com"
+$accessKey = "your-access-key"
+$secretKey = "your-secret-key"
+
+try {
+ # Connect to MinIO
+ $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
+ "Connected to MinIO server for chunked operations demo"
+
+ # Create a demo bucket
+ $bucketName = "chunked-demo-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+ New-MinIOBucket -BucketName $bucketName
+ "Created demo bucket: $bucketName"
+
+ "=== 1. Creating Large Test Files ==="
+ # Create files of different sizes for testing
+
+ # Small file (under chunk size)
+ $smallContent = "Small file content " * 100 # ~2KB
+ $smallContent | Out-File -FilePath "small-file.txt" -Encoding UTF8 -NoNewline
+
+ # Medium file (1-2 chunks)
+ $mediumContent = "Medium file content " * 30000 # ~600KB
+ $mediumContent | Out-File -FilePath "medium-file.txt" -Encoding UTF8 -NoNewline
+
+ # Large file (multiple chunks)
+ $largeContent = "Large file content " * 100000 # ~2MB
+ $largeContent | Out-File -FilePath "large-file.txt" -Encoding UTF8 -NoNewline
+
+ # Very large file (many chunks)
+ $veryLargeContent = "Very large file content " * 250000 # ~6MB
+ $veryLargeContent | Out-File -FilePath "very-large-file.txt" -Encoding UTF8 -NoNewline
+
+ "Created test files of various sizes"
+ Get-ChildItem "*.txt" | Format-Table Name, @{Name="Size";Expression={"$([math]::Round($_.Length/1KB,2)) KB"}}
+ ""
+
+ "=== 2. Chunked Upload with Different Chunk Sizes ==="
+
+ # Upload with 1MB chunks (default)
+ "Uploading medium file with 1MB chunks..."
+ $result1 = New-MinIOObjectChunked -BucketName $bucketName -Files "medium-file.txt" -ChunkSize 1MB -BucketDirectory "uploads/1mb-chunks"
+ $result1 | Format-Table Name, @{Name="SizeMB";Expression={[math]::Round($_.Size/1MB,2)}}, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ ""
+
+ # Upload with 512KB chunks
+ "Uploading large file with 512KB chunks..."
+ $result2 = New-MinIOObjectChunked -BucketName $bucketName -Files "large-file.txt" -ChunkSize 512KB -BucketDirectory "uploads/512kb-chunks"
+ $result2 | Format-Table Name, @{Name="SizeMB";Expression={[math]::Round($_.Size/1MB,2)}}, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ ""
+
+ # Upload with 2MB chunks
+ "Uploading very large file with 2MB chunks..."
+ $result3 = New-MinIOObjectChunked -BucketName $bucketName -Files "very-large-file.txt" -ChunkSize 2MB -BucketDirectory "uploads/2mb-chunks"
+ $result3 | Format-Table Name, @{Name="SizeMB";Expression={[math]::Round($_.Size/1MB,2)}}, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ ""
+
+ "=== 3. Multiple File Chunked Upload ==="
+ # Upload multiple files in one operation
+ "Uploading multiple files with chunked transfer..."
+ $multiResult = New-MinIOObjectChunked -BucketName $bucketName -Files @("small-file.txt", "medium-file.txt") -ChunkSize 1MB -BucketDirectory "uploads/multi-file"
+ $multiResult | Format-Table Name, @{Name="SizeMB";Expression={[math]::Round($_.Size/1MB,2)}}, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ ""
+
+ "=== 4. Chunked Download Operations ==="
+
+ # Download with chunked transfer
+ "Downloading large file with chunked transfer..."
+ $downloadResult = Get-MinIOObjectContentChunked -BucketName $bucketName -ObjectName "uploads/2mb-chunks/very-large-file.txt" -FilePath "downloaded-very-large.txt" -ChunkSize 1MB
+ $downloadResult | Format-Table @{Name="LocalFile";Expression={$_.FilePath.Name}}, @{Name="SizeMB";Expression={[math]::Round($_.FilePath.Length/1MB,2)}}, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ ""
+
+ # Verify download integrity
+ if (Test-Path "downloaded-very-large.txt") {
+ $originalSize = (Get-Item "very-large-file.txt").Length
+ $downloadedSize = (Get-Item "downloaded-very-large.txt").Length
+ if ($originalSize -eq $downloadedSize) {
+ "✅ Download integrity verified - sizes match ($originalSize bytes)"
+ } else {
+ "❌ Download integrity check failed - size mismatch"
+ }
+ }
+ ""
+
+ "=== 5. Performance Comparison ==="
+ # Compare regular vs chunked upload for the same file
+ "Comparing regular vs chunked upload performance..."
+
+ # Regular upload
+ $regularStart = Get-Date
+ $regularResult = New-MinIOObject -BucketName $bucketName -Files "large-file.txt" -BucketDirectory "comparison/regular"
+ $regularEnd = Get-Date
+ $regularDuration = $regularEnd - $regularStart
+
+ # Chunked upload
+ $chunkedStart = Get-Date
+ $chunkedResult = New-MinIOObjectChunked -BucketName $bucketName -Files "large-file.txt" -ChunkSize 1MB -BucketDirectory "comparison/chunked"
+ $chunkedEnd = Get-Date
+ $chunkedDuration = $chunkedEnd - $chunkedStart
+
+ "Performance Comparison for large-file.txt:"
+ [PSCustomObject]@{
+ Method = "Regular"
+ Duration = $regularDuration.ToString("mm\:ss\.fff")
+ Speed = $regularResult.AverageSpeedFormatted
+ } | Format-Table
+
+ [PSCustomObject]@{
+ Method = "Chunked"
+ Duration = $chunkedDuration.ToString("mm\:ss\.fff")
+ Speed = $chunkedResult.AverageSpeedFormatted
+ } | Format-Table
+ ""
+
+ "=== 6. Listing Uploaded Files ==="
+ # Show all uploaded files with their details
+ $allUploads = Get-MinIOObject -BucketName $bucketName -Prefix "uploads/" -ObjectsOnly -SortBy "Size" -Descending
+ "All uploaded files (sorted by size):"
+ $allUploads | Format-Table Name, @{Name="SizeMB";Expression={[math]::Round($_.Size/1MB,2)}}, LastModified -AutoSize
+ ""
+
+ "=== 7. Chunk Size Recommendations ==="
+ "Chunk Size Recommendations:"
+ "• Files < 10MB: Use regular upload (New-MinIOObject)"
+ "• Files 10MB - 100MB: Use 1-5MB chunks"
+ "• Files 100MB - 1GB: Use 5-10MB chunks"
+ "• Files > 1GB: Use 10-50MB chunks"
+ "• Network considerations: Smaller chunks for unstable connections"
+ ""
+
+ # Clean up
+ "Cleaning up demo files..."
+ $allObjects = Get-MinIOObject -BucketName $bucketName
+ foreach ($obj in $allObjects) {
+ if (-not $obj.IsDirectory) {
+ Remove-MinIOObject -BucketName $bucketName -ObjectName $obj.Name -Force
+ }
+ }
+ Remove-MinIOBucket -BucketName $bucketName -Force
+ Remove-Item "small-file.txt", "medium-file.txt", "large-file.txt", "very-large-file.txt", "downloaded-very-large.txt" -Force -ErrorAction SilentlyContinue
+
+ "✅ Chunked operations demo completed"
+
+} catch {
+ "❌ Error: $($_.Exception.Message)"
+}
diff --git a/examples/05-Bulk-Operations.ps1 b/examples/05-Bulk-Operations.ps1
new file mode 100644
index 0000000..3fa9450
--- /dev/null
+++ b/examples/05-Bulk-Operations.ps1
@@ -0,0 +1,205 @@
+# PSMinIO Bulk Operations Example
+# Demonstrates bulk file operations, batch processing, and automation scenarios
+
+# Import the module
+Import-Module ..\Module\PSMinIO\PSMinIO.psd1
+
+# Connection details (replace with your actual values)
+$endpoint = "https://minio.example.com"
+$accessKey = "your-access-key"
+$secretKey = "your-secret-key"
+
+try {
+ # Connect to MinIO
+ $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
+ "Connected to MinIO server for bulk operations demo"
+
+ # Create a demo bucket
+ $bucketName = "bulk-demo-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+ New-MinIOBucket -BucketName $bucketName
+ "Created demo bucket: $bucketName"
+
+ "=== 1. Creating Multiple Test Files ==="
+ # Create a variety of files for bulk operations
+ $testFiles = @()
+
+ # Create document files
+ for ($i = 1; $i -le 5; $i++) {
+ $fileName = "document-$i.txt"
+ "Document $i content - $(Get-Date)" | Out-File -FilePath $fileName -Encoding UTF8
+ $testFiles += $fileName
+ }
+
+ # Create data files
+ for ($i = 1; $i -le 3; $i++) {
+ $fileName = "data-$i.csv"
+ "Name,Value,Date`nItem$i,$(Get-Random -Minimum 100 -Maximum 1000),$(Get-Date)" | Out-File -FilePath $fileName -Encoding UTF8
+ $testFiles += $fileName
+ }
+
+ # Create log files
+ for ($i = 1; $i -le 4; $i++) {
+ $fileName = "log-$i.log"
+ "$(Get-Date) - Log entry $i`n$(Get-Date) - Another log entry" | Out-File -FilePath $fileName -Encoding UTF8
+ $testFiles += $fileName
+ }
+
+ "Created $($testFiles.Count) test files"
+ Get-ChildItem "*.txt", "*.csv", "*.log" | Format-Table Name, @{Name="Size";Expression={"$($_.Length) bytes"}} -AutoSize
+ ""
+
+ "=== 2. Bulk Upload to Different Directories ==="
+ # Upload different file types to organized directories
+
+ # Upload documents
+ $docFiles = Get-ChildItem "document-*.txt"
+ if ($docFiles) {
+ "Uploading $($docFiles.Count) document files..."
+ $docResults = New-MinIOObject -BucketName $bucketName -Files $docFiles.Name -BucketDirectory "documents/$(Get-Date -Format 'yyyy/MM')"
+ $docResults | Format-Table Name, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ }
+ ""
+
+ # Upload data files
+ $dataFiles = Get-ChildItem "data-*.csv"
+ if ($dataFiles) {
+ "Uploading $($dataFiles.Count) data files..."
+ $dataResults = New-MinIOObject -BucketName $bucketName -Files $dataFiles.Name -BucketDirectory "data/exports"
+ $dataResults | Format-Table Name, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ }
+ ""
+
+ # Upload log files
+ $logFiles = Get-ChildItem "log-*.log"
+ if ($logFiles) {
+ "Uploading $($logFiles.Count) log files..."
+ $logResults = New-MinIOObject -BucketName $bucketName -Files $logFiles.Name -BucketDirectory "logs/application/$(Get-Date -Format 'yyyy-MM-dd')"
+ $logResults | Format-Table Name, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ }
+ ""
+
+ "=== 3. Bulk File Analysis ==="
+ # Analyze uploaded files by type and location
+ $allObjects = Get-MinIOObject -BucketName $bucketName -ObjectsOnly
+
+ "File distribution by directory:"
+ $allObjects | Group-Object { ($_.Name -split '/')[0] } | Format-Table Name, Count -AutoSize
+ ""
+
+ "File distribution by extension:"
+ $allObjects | Group-Object { [System.IO.Path]::GetExtension($_.Name) } | Format-Table Name, Count -AutoSize
+ ""
+
+ "Largest files:"
+ $allObjects | Sort-Object Size -Descending | Select-Object -First 5 | Format-Table Name, @{Name="Size";Expression={"$($_.Size) bytes"}}, LastModified -AutoSize
+ ""
+
+ "=== 4. Batch Download Operations ==="
+ # Download files by pattern/criteria
+
+ # Create download directory
+ $downloadDir = "downloads"
+ if (-not (Test-Path $downloadDir)) {
+ New-Item -ItemType Directory -Path $downloadDir | Out-Null
+ }
+
+ # Download all CSV files
+ $csvObjects = Get-MinIOObject -BucketName $bucketName | Where-Object { $_.Name -like "*.csv" }
+ "Downloading $($csvObjects.Count) CSV files..."
+ foreach ($csvObj in $csvObjects) {
+ $localFileName = [System.IO.Path]::GetFileName($csvObj.Name)
+ $localPath = Join-Path $downloadDir $localFileName
+ $downloadResult = Get-MinIOObjectContent -BucketName $bucketName -ObjectName $csvObj.Name -FilePath $localPath
+ "Downloaded: $($csvObj.Name) -> $localPath"
+ }
+ ""
+
+ # Download files from specific directory
+ $docObjects = Get-MinIOObject -BucketName $bucketName -Prefix "documents/"
+ "Downloading $($docObjects.Count) files from documents directory..."
+ foreach ($docObj in $docObjects) {
+ if (-not $docObj.IsDirectory) {
+ $localFileName = [System.IO.Path]::GetFileName($docObj.Name)
+ $localPath = Join-Path $downloadDir "doc-$localFileName"
+ $downloadResult = Get-MinIOObjectContent -BucketName $bucketName -ObjectName $docObj.Name -FilePath $localPath
+ "Downloaded: $($docObj.Name) -> $localPath"
+ }
+ }
+ ""
+
+ "=== 5. Bulk Operations with Filtering ==="
+ # Demonstrate advanced bulk operations
+
+ # Find and process files by size
+ $largeFiles = Get-MinIOObject -BucketName $bucketName -ObjectsOnly | Where-Object { $_.Size -gt 50 }
+ "Processing $($largeFiles.Count) files larger than 50 bytes:"
+ $largeFiles | Format-Table Name, @{Name="Size";Expression={"$($_.Size) bytes"}}, LastModified -AutoSize
+ ""
+
+ # Find files by date (last hour)
+ $recentFiles = Get-MinIOObject -BucketName $bucketName -ObjectsOnly | Where-Object { $_.LastModified -gt (Get-Date).AddHours(-1) }
+ "Files uploaded in the last hour: $($recentFiles.Count)"
+ $recentFiles | Format-Table Name, LastModified -AutoSize
+ ""
+
+ "=== 6. Bulk Cleanup Operations ==="
+ # Demonstrate selective cleanup
+
+ # Remove files by pattern
+ $logObjects = Get-MinIOObject -BucketName $bucketName | Where-Object { $_.Name -like "*log*" -and -not $_.IsDirectory }
+ "Removing $($logObjects.Count) log files..."
+ foreach ($logObj in $logObjects) {
+ Remove-MinIOObject -BucketName $bucketName -ObjectName $logObj.Name -Force
+ "Removed: $($logObj.Name)"
+ }
+ ""
+
+ # Remove files older than a certain date (simulated)
+ $cutoffDate = (Get-Date).AddMinutes(-5) # 5 minutes ago for demo
+ $oldFiles = Get-MinIOObject -BucketName $bucketName -ObjectsOnly | Where-Object { $_.LastModified -lt $cutoffDate }
+ if ($oldFiles.Count -gt 0) {
+ "Removing $($oldFiles.Count) files older than $cutoffDate..."
+ foreach ($oldFile in $oldFiles) {
+ Remove-MinIOObject -BucketName $bucketName -ObjectName $oldFile.Name -Force
+ "Removed: $($oldFile.Name)"
+ }
+ } else {
+ "No files older than $cutoffDate found"
+ }
+ ""
+
+ "=== 7. Final Statistics ==="
+ # Show final state
+ $remainingObjects = Get-MinIOObject -BucketName $bucketName -ObjectsOnly
+ "Remaining files after cleanup: $($remainingObjects.Count)"
+ if ($remainingObjects.Count -gt 0) {
+ $remainingObjects | Format-Table Name, @{Name="Size";Expression={"$($_.Size) bytes"}}, LastModified -AutoSize
+ }
+ ""
+
+ "Downloaded files:"
+ if (Test-Path $downloadDir) {
+ Get-ChildItem $downloadDir | Format-Table Name, @{Name="Size";Expression={"$($_.Length) bytes"}}, LastWriteTime -AutoSize
+ }
+
+ # Clean up
+ "Cleaning up demo files..."
+ $allObjects = Get-MinIOObject -BucketName $bucketName
+ foreach ($obj in $allObjects) {
+ if (-not $obj.IsDirectory) {
+ Remove-MinIOObject -BucketName $bucketName -ObjectName $obj.Name -Force
+ }
+ }
+ Remove-MinIOBucket -BucketName $bucketName -Force
+
+ # Clean up local files
+ Remove-Item $testFiles -Force -ErrorAction SilentlyContinue
+ if (Test-Path $downloadDir) {
+ Remove-Item $downloadDir -Recurse -Force -ErrorAction SilentlyContinue
+ }
+
+ "✅ Bulk operations demo completed"
+
+} catch {
+ "❌ Error: $($_.Exception.Message)"
+}
diff --git a/examples/06-Enterprise-Automation.ps1 b/examples/06-Enterprise-Automation.ps1
new file mode 100644
index 0000000..4dad6f4
--- /dev/null
+++ b/examples/06-Enterprise-Automation.ps1
@@ -0,0 +1,291 @@
+# PSMinIO Enterprise Automation Example
+# Demonstrates enterprise-grade automation scenarios including monitoring, policies, and scheduled operations
+
+# Import the module
+Import-Module ..\Module\PSMinIO\PSMinIO.psd1
+
+# Connection details (replace with your actual values)
+$endpoint = "https://minio.example.com"
+$accessKey = "your-access-key"
+$secretKey = "your-secret-key"
+
+# Configuration
+$logFile = "minio-automation-$(Get-Date -Format 'yyyyMMdd').log"
+$reportFile = "minio-report-$(Get-Date -Format 'yyyyMMdd-HHmmss').html"
+
+function Write-Log {
+ param([string]$Message, [string]$Level = "INFO")
+ $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+ $logEntry = "[$timestamp] [$Level] $Message"
+ $logEntry | Out-File -FilePath $logFile -Append -Encoding UTF8
+ $logEntry
+}
+
+try {
+ Write-Log "Starting MinIO enterprise automation demo"
+
+ # Connect to MinIO
+ $connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
+ Write-Log "Connected to MinIO server: $endpoint"
+
+ "=== 1. Infrastructure Health Check ==="
+ # Perform comprehensive health checks
+ Write-Log "Performing infrastructure health check"
+
+ # Check server connectivity and basic operations
+ try {
+ $buckets = Get-MinIOBucket
+ Write-Log "✅ Server connectivity: OK ($($buckets.Count) buckets found)"
+ "✅ Server connectivity: OK ($($buckets.Count) buckets found)"
+ } catch {
+ Write-Log "❌ Server connectivity: FAILED - $($_.Exception.Message)" "ERROR"
+ "❌ Server connectivity: FAILED"
+ throw
+ }
+
+ # Test bucket operations
+ $testBucketName = "health-check-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+ try {
+ New-MinIOBucket -BucketName $testBucketName
+ $testExists = Test-MinIOBucketExists -BucketName $testBucketName
+ Remove-MinIOBucket -BucketName $testBucketName -Force
+ Write-Log "✅ Bucket operations: OK"
+ "✅ Bucket operations: OK"
+ } catch {
+ Write-Log "❌ Bucket operations: FAILED - $($_.Exception.Message)" "ERROR"
+ "❌ Bucket operations: FAILED"
+ }
+ ""
+
+ "=== 2. Storage Statistics and Monitoring ==="
+ # Collect comprehensive storage statistics
+ Write-Log "Collecting storage statistics"
+
+ $stats = Get-MinIOStats -MaxObjectsToCount 1000
+ Write-Log "Storage stats collected: $($stats.TotalBuckets) buckets, $($stats.TotalObjects) objects, $($stats.TotalSizeFormatted)"
+
+ "Storage Overview:"
+ $stats | Format-List TotalBuckets, TotalObjects, TotalSizeFormatted, AverageObjectSizeFormatted
+ ""
+
+ # Detailed bucket analysis
+ "Bucket Analysis:"
+ $bucketStats = Get-MinIOBucket -IncludeStatistics
+ $bucketStats | Format-Table Name, @{Name="Objects";Expression={$_.ObjectCount}}, @{Name="Size";Expression={$_.SizeFormatted}}, CreationDate -AutoSize
+ ""
+
+ "=== 3. Automated Backup Operations ==="
+ # Simulate automated backup scenario
+ Write-Log "Starting automated backup operations"
+
+ $backupBucket = "automated-backups-$(Get-Date -Format 'yyyyMMdd')"
+ New-MinIOBucket -BucketName $backupBucket
+ Write-Log "Created backup bucket: $backupBucket"
+
+ # Create sample data to backup
+ $backupData = @{
+ "config-backup.json" = @{
+ timestamp = Get-Date
+ server = $env:COMPUTERNAME
+ version = "1.0"
+ } | ConvertTo-Json
+
+ "database-backup.sql" = "-- Database backup generated on $(Get-Date)`nSELECT * FROM users;"
+
+ "logs-backup.txt" = "Application logs backup`n$(Get-Date) - System started`n$(Get-Date) - Backup initiated"
+ }
+
+ foreach ($file in $backupData.Keys) {
+ $backupData[$file] | Out-File -FilePath $file -Encoding UTF8
+ }
+
+ # Perform backup with organized directory structure
+ $backupDate = Get-Date -Format "yyyy/MM/dd"
+ $backupTime = Get-Date -Format "HH-mm"
+
+ $backupResults = New-MinIOObject -BucketName $backupBucket -Files $backupData.Keys -BucketDirectory "daily-backups/$backupDate/$backupTime"
+ Write-Log "Backup completed: $($backupResults.Count) files uploaded"
+
+ "Backup Results:"
+ $backupResults | Format-Table Name, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
+ ""
+
+ "=== 4. Data Lifecycle Management ==="
+ # Simulate data lifecycle management
+ Write-Log "Performing data lifecycle management"
+
+ # Create lifecycle demo bucket
+ $lifecycleBucket = "lifecycle-demo-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+ New-MinIOBucket -BucketName $lifecycleBucket
+
+ # Upload files with different "ages" (simulated by different directories)
+ $lifecycleFiles = @(
+ @{ Name = "current-data.txt"; Content = "Current data"; Directory = "current" }
+ @{ Name = "week-old-data.txt"; Content = "Week old data"; Directory = "archive/weekly" }
+ @{ Name = "month-old-data.txt"; Content = "Month old data"; Directory = "archive/monthly" }
+ @{ Name = "year-old-data.txt"; Content = "Year old data"; Directory = "archive/yearly" }
+ )
+
+ foreach ($file in $lifecycleFiles) {
+ $file.Content | Out-File -FilePath $file.Name -Encoding UTF8
+ New-MinIOObject -BucketName $lifecycleBucket -Files $file.Name -BucketDirectory $file.Directory
+ Remove-Item $file.Name -Force
+ }
+
+ # Analyze data by lifecycle stage
+ $allLifecycleObjects = Get-MinIOObject -BucketName $lifecycleBucket -ObjectsOnly
+ "Data Lifecycle Analysis:"
+ $allLifecycleObjects | Group-Object { ($_.Name -split '/')[0] } | Format-Table Name, Count -AutoSize
+ ""
+
+ "=== 5. Security and Compliance Audit ==="
+ # Perform security audit
+ Write-Log "Performing security and compliance audit"
+
+ $auditResults = @()
+
+ # Check bucket policies
+ foreach ($bucket in $buckets) {
+ try {
+ $policy = Get-MinIOBucketPolicy -BucketName $bucket.Name
+ $auditResults += [PSCustomObject]@{
+ Bucket = $bucket.Name
+ HasPolicy = $policy -ne $null
+ PolicySize = if ($policy) { $policy.Length } else { 0 }
+ Status = if ($policy) { "Policy Configured" } else { "No Policy" }
+ }
+ } catch {
+ $auditResults += [PSCustomObject]@{
+ Bucket = $bucket.Name
+ HasPolicy = $false
+ PolicySize = 0
+ Status = "Policy Check Failed"
+ }
+ }
+ }
+
+ "Security Audit Results:"
+ $auditResults | Format-Table Bucket, HasPolicy, Status -AutoSize
+ Write-Log "Security audit completed: $($auditResults.Count) buckets audited"
+ ""
+
+ "=== 6. Performance Monitoring ==="
+ # Monitor performance metrics
+ Write-Log "Collecting performance metrics"
+
+ # Test upload/download performance
+ $perfTestFile = "performance-test.txt"
+ $perfTestContent = "Performance test data " * 1000 # ~20KB
+ $perfTestContent | Out-File -FilePath $perfTestFile -Encoding UTF8 -NoNewline
+
+ $perfBucket = "performance-test-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
+ New-MinIOBucket -BucketName $perfBucket
+
+ # Measure upload performance
+ $uploadStart = Get-Date
+ $uploadResult = New-MinIOObject -BucketName $perfBucket -Files $perfTestFile
+ $uploadEnd = Get-Date
+ $uploadDuration = $uploadEnd - $uploadStart
+
+ # Measure download performance
+ $downloadStart = Get-Date
+ $downloadResult = Get-MinIOObjectContent -BucketName $perfBucket -ObjectName $perfTestFile -FilePath "downloaded-$perfTestFile"
+ $downloadEnd = Get-Date
+ $downloadDuration = $downloadEnd - $downloadStart
+
+ "Performance Metrics:"
+ [PSCustomObject]@{
+ Operation = "Upload"
+ Duration = $uploadDuration.TotalMilliseconds
+ Speed = $uploadResult.AverageSpeedFormatted
+ FileSize = (Get-Item $perfTestFile).Length
+ } | Format-Table
+
+ [PSCustomObject]@{
+ Operation = "Download"
+ Duration = $downloadDuration.TotalMilliseconds
+ Speed = $downloadResult.AverageSpeedFormatted
+ FileSize = (Get-Item "downloaded-$perfTestFile").Length
+ } | Format-Table
+
+ Write-Log "Performance test completed - Upload: $($uploadDuration.TotalMilliseconds)ms, Download: $($downloadDuration.TotalMilliseconds)ms"
+ ""
+
+ "=== 7. Generating HTML Report ==="
+ # Generate comprehensive HTML report
+ Write-Log "Generating HTML report"
+
+ $htmlReport = @"
+
+
+
+ MinIO Enterprise Report - $(Get-Date -Format 'yyyy-MM-dd HH:mm:ss')
+
+
+
+
+
+
+
Storage Overview
+
Total Buckets: $($stats.TotalBuckets)
+
Total Objects: $($stats.TotalObjects)
+
Total Size: $($stats.TotalSizeFormatted)
+
+
Health Check Results
+
✅ Server Connectivity: OK
+
✅ Bucket Operations: OK
+
+
Performance Metrics
+
Upload Performance: $($uploadResult.AverageSpeedFormatted)
+
Download Performance: $($downloadResult.AverageSpeedFormatted)
+
+
Security Audit
+
$($auditResults.Count) buckets audited
+
Buckets with policies: $(($auditResults | Where-Object HasPolicy).Count)
+