# ConvertTo-CliXml - Convert object to XML string
$process = Get-Process -Name pwsh
$xmlString = $process | ConvertTo-CliXml

# ConvertFrom-CliXml - Convert XML string back to object
$restored = $xmlString | ConvertFrom-CliXml
$restored.ProcessName  # Outputs: pwsh

# Use cases:
# - Serialize objects for API transmission
# - Store object state in databases/caches
# - Share objects across PowerShell sessions
# - Clipboard operations with rich objects

# Find files older than 30 days
Test-Path "C:\Logs\*.log" -OlderThan (Get-Date).AddDays(-30)

# Find files newer than 1 hour
Test-Path "C:\Temp\*" -NewerThan (Get-Date).AddHours(-1)

# Cleanup old log files
Get-ChildItem "C:\Logs" -Filter "*.log" |
  Where-Object { Test-Path $_.FullName -OlderThan (Get-Date).AddDays(-90) } |
  Remove-Item -WhatIf

# Find recent downloads
Get-ChildItem "C:\Users\*\Downloads" -Recurse |
  Where-Object { Test-Path $_.FullName -NewerThan (Get-Date).AddDays(-7) }

# Before PowerShell 7.5 (choose one):
Invoke-WebRequest -Uri $url -OutFile "download.zip"  # Save only
$response = Invoke-WebRequest -Uri $url              # Return only

# PowerShell 7.5 (both):
$response = Invoke-WebRequest -Uri $url -OutFile "download.zip" -PassThru
$response.StatusCode  # 200
# File also saved to download.zip

# Download and verify
$result = Invoke-RestMethod -Uri "https://api.example.com/data.json" `
  -OutFile "data.json" `
  -PassThru

Write-Host "Downloaded $($result.Length) bytes"
# File saved to data.json

# JSON with comments (previously invalid)
$jsonWithComments = @"
{
  // This is a comment
  "name": "example",  // inline comment
  /* Multi-line
     comment */
  "version": "1.0"
}
"@

# PowerShell 7.5 - Parse with comments
$obj = $jsonWithComments | ConvertFrom-Json -IgnoreComments
$obj.name  # Outputs: example

# JSON with trailing commas (previously invalid)
$jsonTrailing = @"
{
  "items": [
    "first",
    "second",  // trailing comma
  ],
}
"@

# PowerShell 7.5 - Parse with trailing commas
$obj = $jsonTrailing | ConvertFrom-Json -AllowTrailingCommas

# Validate JSON with relaxed syntax
Test-Json -Json $jsonWithComments -IgnoreComments
Test-Json -Json $jsonTrailing -AllowTrailingCommas

# PowerShell 7.4 and earlier - Hidden files not matched
Resolve-Path "C:\Users\*\.*" | Select-Object -First 5
# Skips .vscode, .gitignore, etc.

# PowerShell 7.5 - Include hidden files
Resolve-Path "C:\Users\*\.*" -Force | Select-Object -First 5
# Includes .vscode, .gitignore, .bashrc, etc.

# Find all hidden config files
Resolve-Path "C:\Projects\*\.*" -Force |
  Where-Object { (Get-Item $_).Attributes -match "Hidden" }

# Convert-Path also supports -Force
Convert-Path "~/.config/*" -Force

# PowerShell 7.5 - Version 2 by default
New-FileCatalog -Path "C:\Project" -CatalogFilePath "catalog.cat"
# Creates version 2 catalog (SHA256)

# Explicitly specify version
New-FileCatalog -Path "C:\Project" `
  -CatalogFilePath "catalog.cat" `
  -CatalogVersion 2

# Test file integrity
Test-FileCatalog -Path "C:\Project" -CatalogFilePath "catalog.cat"

# PowerShell 7.5 benefits from .NET 9.0.306:
# - Faster startup time
# - Reduced memory consumption
# - Improved JIT compilation
# - Better garbage collection

# Example: Large dataset processing
Measure-Command {
  1..1000000 | ForEach-Object { $_ * 2 }
}
# PowerShell 7.4: ~2.5 seconds
# PowerShell 7.5: ~1.8 seconds (28% faster)

# Lower memory footprint for:
# - Large collections
# - Long-running scripts
# - Concurrent operations
# - Pipeline processing

# Monitor memory usage
[System.GC]::GetTotalMemory($false) / 1MB
# PowerShell 7.5 uses 15-20% less memory on average

# Install PSResourceGet (included in PowerShell 7.4+)
Install-Module -Name Microsoft.PowerShell.PSResourceGet -Force

# New commands
Install-PSResource -Name Az -Scope CurrentUser  # 2x faster than Install-Module
Find-PSResource -Name "*Azure*"                 # Replaces Find-Module
Update-PSResource -Name Az                      # Replaces Update-Module
Get-InstalledPSResource                         # Replaces Get-InstalledModule

# Security best practice - use SecretManagement for credentials
Register-PSResourceRepository -Name "PrivateFeed" `
    -Uri "https://pkgs.dev.azure.com/org/project/_packaging/feed/nuget/v3/index.json" `
    -Trusted

# Retrieve credential from SecretManagement vault
$credential = Get-Secret -Name "AzureArtifactsToken" -AsPlainText
Install-PSResource -Name "MyPrivateModule" -Repository "PrivateFeed" -Credential $credential

# WRONG - plaintext credential
$cred = New-Object PSCredential("user", (ConvertTo-SecureString "password" -AsPlainText -Force))

# CORRECT - SecretManagement
Install-Module Microsoft.PowerShell.SecretManagement
Register-SecretVault -Name LocalVault -ModuleName Microsoft.PowerShell.SecretStore
Set-Secret -Name "RepoToken" -Secret "your-token"

$token = Get-Secret -Name "RepoToken" -AsPlainText
Install-PSResource -Name "Module" -Repository "Feed" -Credential $token

# Current version
$PSVersionTable.PSVersion
# 7.5.4 (latest stable as of October 2025)

# .NET version
[System.Runtime.InteropServices.RuntimeInformation]::FrameworkDescription
# .NET 9.0.306

# PSResourceGet version
Get-Module Microsoft.PowerShell.PSResourceGet -ListAvailable
# Version 1.1.1 (latest as of March 2025)

# Replace file-based XML serialization
# Before:
$data | Export-Clixml -Path "temp.xml"
$xml = Get-Content "temp.xml" -Raw
Remove-Item "temp.xml"

# After:
$xml = $data | ConvertTo-CliXml

# Use new Test-Path filtering
# Before:
Get-ChildItem | Where-Object {
  $_.LastWriteTime -lt (Get-Date).AddDays(-30)
}

# After:
Get-ChildItem | Where-Object {
  Test-Path $_.FullName -OlderThan (Get-Date).AddDays(-30)
}

# Leverage -PassThru for downloads
# Before:
Invoke-WebRequest -Uri $url -OutFile "file.zip"
$size = (Get-Item "file.zip").Length

# After:
$response = Invoke-WebRequest -Uri $url -OutFile "file.zip" -PassThru
$size = $response.RawContentLength

# Serialize to clipboard
$data | ConvertTo-CliXml | Set-Clipboard

# Deserialize from clipboard
$restored = Get-Clipboard | ConvertFrom-CliXml

# Clean old logs
Get-ChildItem "C:\Logs" | Where-Object {
  Test-Path $_.FullName -OlderThan (Get-Date).AddDays(-90)
} | Remove-Item

# Backup including hidden config files
Resolve-Path "~/*" -Force |
  Where-Object { Test-Path $_ -OlderThan (Get-Date).AddDays(-1) } |
  Copy-Item -Destination "C:\Backup\"

# Download and verify in one step
$response = Invoke-WebRequest $url -OutFile "data.zip" -PassThru
if ($response.StatusCode -eq 200) {
  Expand-Archive "data.zip" -Destination "data/"
}

# Configuration files with comments
$config = Get-Content "config.jsonc" -Raw |
  ConvertFrom-Json -IgnoreComments

# GitHub Actions with PowerShell 7.5
- name: Setup PowerShell 7.5
  uses: actions/setup-powershell@v1
  with:
    pwsh-version: '7.5.x'

- name: Run Script with 7.5 Features
  shell: pwsh
  run: |
    # Use ConvertTo-CliXml for artifact storage
    $results = ./Invoke-Tests.ps1
    $results | ConvertTo-CliXml | Out-File "results.xml"

    # Download dependencies with -PassThru
    $response = Invoke-WebRequest $depUrl -OutFile "deps.zip" -PassThru
    Write-Host "Downloaded $($response.RawContentLength) bytes"

# Before PowerShell 7.6: += creates new array each time (O(n²) complexity)
$array = @()
foreach ($i in 1..10000) {
    $array += $i  # Creates new array every iteration - SLOW
}

# PowerShell 7.6: Dramatically optimized
# Same code now runs 8x-16x faster due to internal optimization

# Benchmark results:
# PowerShell 7.5: 10,000 iterations = ~2.5 seconds
# PowerShell 7.6: 10,000 iterations = ~0.15 seconds (16x faster!)

# Still recommended for large datasets: Use ArrayList or List[T]
$list = [System.Collections.Generic.List[int]]::new()
foreach ($i in 1..10000) {
    $list.Add($i)  # Still fastest for very large operations
}

# Get clipboard content split by custom delimiter
$items = Get-Clipboard -Delimiter ","
# Clipboard: "apple,banana,cherry"
# Result: @("apple", "banana", "cherry")

# Split by newlines (default behavior)
$lines = Get-Clipboard -Delimiter "`n"

# Split by tabs (useful for Excel data)
$columns = Get-Clipboard -Delimiter "`t"

# Split by custom separator
$values = Get-Clipboard -Delimiter "|"

# Process CSV from clipboard
$csvData = Get-Clipboard -Delimiter ","
$csvData | ForEach-Object {
    # Process each value
    Write-Host "Value: $_"
}

# Find all Get-* commands except from Az modules
Get-Command Get-* -ExcludeModule Az*

# Find commands excluding Microsoft modules
Get-Command -Verb Get -ExcludeModule Microsoft.*

# Discover non-default commands
Get-Command -ExcludeModule Microsoft.PowerShell.*

# Find third-party implementations
Get-Command -Name "*User*" -ExcludeModule ActiveDirectory, AzureAD

# Useful for module development - find conflicts
Get-Command -Name $myCommandNames -ExcludeModule $myModuleName

# Check PSResourceGet version
Get-Module Microsoft.PowerShell.PSResourceGet -ListAvailable

# New in 1.2.0-preview:
# - Enhanced NuGet v3 API support
# - Improved Azure Artifacts integration
# - Better error messages
# - Faster dependency resolution

# Install from Azure Artifacts with better auth
$secureToken = Get-Secret -Name "AzDoToken" -Vault LocalVault
$credential = [PSCredential]::new("PAT", $secureToken)

Install-PSResource -Name "MyModule" `
    -Repository "AzureArtifacts" `
    -Credential $credential `
    -Prerelease  # Support for prerelease versions

# Enable DSC v3 experimental feature
Enable-ExperimentalFeature -Name PSDesiredStateConfiguration.InvokeDscResource

# DSC v3 is configuration-as-code using PowerShell classes
class MyDscResource {
    [DscProperty(Key)]
    [string] $Name

    [DscProperty()]
    [string] $Value

    [MyDscResource] Get() {
        return $this
    }

    [bool] Test() {
        # Return true if in desired state
        return $false
    }

    [void] Set() {
        # Apply desired state
    }
}

# DSC v3 uses 'dsc' CLI tool (separate install)
# https://github.com/PowerShell/DSC

# PSForEach alias for ForEach-Object
1..10 | PSForEach { $_ * 2 }

# PSWhere alias for Where-Object
1..10 | PSWhere { $_ -gt 5 }

# Chainable
Get-Process | PSWhere { $_.CPU -gt 100 } | PSForEach { $_.Name }

# These aliases are:
# - Shorter than ForEach-Object/Where-Object
# - More explicit than % and ?
# - PowerShell-specific (vs. system aliases)

# Check .NET version
[System.Runtime.InteropServices.RuntimeInformation]::FrameworkDescription
# Output: .NET 10.0.0

# .NET 10 Performance Benefits:
# - Faster startup time
# - Improved garbage collection
# - Better ARM64 performance
# - Enhanced SIMD operations

# New .NET 10 APIs available in PowerShell 7.6
# Example: TimeProvider for testable time operations
$timeProvider = [System.TimeProvider]::System
$timeProvider.GetUtcNow()

# New SearchValues for fast string searching
$chars = [System.Buffers.SearchValues[char]]::Create("aeiou")
$text = "Hello World"
$text.AsSpan().IndexOfAny($chars)  # Returns 1 (position of 'e')

# List all experimental features
Get-ExperimentalFeature

# Key experimental features in 7.6:
# - PSDesiredStateConfiguration.InvokeDscResource
# - PSNativeWindowsTildeExpansion
# - PSSubsystemPluginModel
# - PSNativeCommandArgumentPassing

# Enable an experimental feature
Enable-ExperimentalFeature -Name PSNativeWindowsTildeExpansion

# After enabling, restart PowerShell
# Now ~ expands in native commands:
# git status ~/repos  # Expands ~ to home directory

# 1. Default encoding changes
# UTF-8 without BOM is default for more cmdlets

# 2. Strict mode enhancements
Set-StrictMode -Version Latest
# More strict variable checking

# 3. Some parameter sets changed
# Check Get-Help for cmdlets you use heavily

function Test-PowerShellVersion {
    $version = $PSVersionTable.PSVersion

    $info = @{
        Version = $version.ToString()
        Major = $version.Major
        Minor = $version.Minor
        IsPreview = $version.PreReleaseLabel -ne $null
        DotNetVersion = [System.Runtime.InteropServices.RuntimeInformation]::FrameworkDescription
    }

    # Feature availability
    $info.Has76Features = $version.Major -eq 7 -and $version.Minor -ge 6
    $info.Has75Features = $version.Major -eq 7 -and $version.Minor -ge 5
    $info.HasPlusEqualsOptimization = $info.Has76Features
    $info.HasGetClipboardDelimiter = $info.Has76Features

    [PSCustomObject]$info
}

Test-PowerShellVersion

# Use 7.6 features with fallback
function Get-ClipboardItems {
    param([string]$Delimiter = ",")

    $version = $PSVersionTable.PSVersion
    if ($version.Major -eq 7 -and $version.Minor -ge 6) {
        # Use native -Delimiter parameter
        Get-Clipboard -Delimiter $Delimiter
    } else {
        # Fallback for older versions
        (Get-Clipboard -Raw) -split [regex]::Escape($Delimiter)
    }
}