PowerShell niveau 4 — Scripts et fonctions

<#
.SYNOPSIS
    Produit la fiche d'identité de la machine locale.
.EXAMPLE
    .\Get-FicheMachine.ps1 -CheminExport C:\Temp\fiche.json -Format JSON
#>
param(
    [string]$CheminExport,
    [ValidateSet("CSV", "JSON")][string]$Format = "CSV"
)

$os = Get-CimInstance Win32_OperatingSystem
$cs = Get-CimInstance Win32_ComputerSystem

$fiche = [PSCustomObject]@{
    Machine       = $env:COMPUTERNAME
    Utilisateur   = $env:USERNAME
    Systeme       = $os.Caption
    PowerShell    = $PSVersionTable.PSVersion.ToString()
    MemoireGo     = [math]::Round($cs.TotalPhysicalMemory / 1GB, 1)
    DisqueCLibreGo = [math]::Round((Get-PSDrive C).Free / 1GB, 1)
    DateReleve    = Get-Date
}

if ($CheminExport) {
    if ($Format -eq "CSV") {
        $fiche | Export-Csv $CheminExport -Delimiter ";" -Encoding UTF8 -NoTypeInformation
    } else {
        $fiche | ConvertTo-Json | Out-File $CheminExport -Encoding utf8
    }
}
$fiche

Explication

Le script renvoie un objet, ce qui permet de l’enchaîner : .\Get-FicheMachine.ps1 | Export-Csv ... fonctionne même sans le paramètre d’export. C’est la bonne pratique : une fonction produit des données, l’appelant décide de leur destination.

function Test-Service {
    [CmdletBinding()]
    param([Parameter(Mandatory)][string]$Nom)

    Write-Verbose "Recherche du service $Nom"
    $service = Get-Service -Name $Nom -ErrorAction SilentlyContinue

    [PSCustomObject]@{
        Nom     = $Nom
        Existe  = [bool]$service
        Etat    = if ($service) { $service.Status } else { "N/A" }
    }
}

function Backup-Fichier {
    [CmdletBinding(SupportsShouldProcess)]
    param(
        [Parameter(Mandatory)][string]$Chemin,
        [string]$Destination = "$env:USERPROFILE\Sauvegardes"
    )

    try {
        $fichier = Get-Item $Chemin -ErrorAction Stop
        if (-not (Test-Path $Destination)) {
            New-Item $Destination -ItemType Directory -Force | Out-Null
        }
        $nouveau = "{0}_{1}{2}" -f $fichier.BaseName, (Get-Date -Format "yyyyMMdd-HHmm"), $fichier.Extension
        $cible = Join-Path $Destination $nouveau

        if ($PSCmdlet.ShouldProcess($cible, "Copie de sauvegarde")) {
            Copy-Item $fichier.FullName $cible -ErrorAction Stop
            Write-Verbose "Copié vers $cible"
        }
    }
    catch {
        Write-Error "Sauvegarde impossible : $($_.Exception.Message)"
    }
}

Explication

Test-Service ne plante jamais car elle utilise -ErrorAction SilentlyContinue puis teste la variable. [bool]$service convertit l’objet (ou $null) en vrai/faux. Backup-Fichier, elle, a besoin de -ErrorAction Stop pour que try/catch intercepte l’erreur.

Pour aller plus loin

# Le même test sur plusieurs services, grâce au pipeline
"Spooler", "BITS", "Inexistant" | ForEach-Object { Test-Service -Nom $_ } | Format-Table -AutoSize

<#
.SYNOPSIS
    Supprime les fichiers temporaires anciens d'un dossier, avec journalisation.
.PARAMETER Dossier
    Dossier à nettoyer (obligatoire).
.PARAMETER JoursAnciennete
    Âge minimal des fichiers supprimés, en jours (1 à 365, défaut 30).
.EXAMPLE
    .\Clean-Temp.ps1 -Dossier C:\Temp -JoursAnciennete 60 -WhatIf
.NOTES
    Auteur : Bruno Jousseaume
#>
[CmdletBinding(SupportsShouldProcess)]
param(
    [Parameter(Mandatory)][string]$Dossier,
    [ValidateRange(1, 365)][int]$JoursAnciennete = 30,
    [string[]]$Extension = @("*.tmp", "*.log"),
    [string]$Journal = "$PSScriptRoot\clean-temp.log"
)

function Write-Journal {
    param([string]$Message, [ValidateSet("INFO", "ALERTE", "ERREUR")][string]$Niveau = "INFO")
    "{0} [{1}] {2} - {3}" -f (Get-Date -Format "yyyy-MM-dd HH:mm:ss"), $Niveau, $env:USERNAME, $Message |
        Add-Content -Path $Journal -Encoding utf8
}

# Garde-fous
$interdits = @("C:\", "C:\Windows", "C:\Windows\System32", "C:\Program Files", $env:USERPROFILE)
$chemin = (Resolve-Path $Dossier -ErrorAction SilentlyContinue).Path
if (-not $chemin) {
    Write-Journal "Dossier introuvable : $Dossier" -Niveau ERREUR
    throw "Dossier introuvable : $Dossier"
}
if ($interdits -contains $chemin.TrimEnd("\")) {
    Write-Journal "Refus de nettoyer un dossier protégé : $chemin" -Niveau ALERTE
    throw "Dossier protégé, nettoyage refusé."
}

$limite = (Get-Date).AddDays(-$JoursAnciennete)
$cibles = Get-ChildItem -Path $chemin -File -Recurse -Include $Extension -ErrorAction SilentlyContinue |
    Where-Object LastWriteTime -lt $limite

$octets = ($cibles | Measure-Object Length -Sum).Sum
$supprimes = 0

foreach ($f in $cibles) {
    if ($PSCmdlet.ShouldProcess($f.FullName, "Suppression")) {
        try {
            Remove-Item $f.FullName -Force -ErrorAction Stop
            Write-Journal "Supprimé : $($f.FullName)"
            $supprimes++
        }
        catch {
            Write-Journal "Échec sur $($f.FullName) : $($_.Exception.Message)" -Niveau ERREUR
        }
    }
}

$resume = [PSCustomObject]@{
    Dossier        = $chemin
    FichiersTrouves = $cibles.Count
    FichiersSupprimes = $supprimes
    EspaceLibereMo = [math]::Round($octets / 1MB, 1)
    Date           = Get-Date
}
Write-Journal "Bilan : $supprimes fichier(s), $($resume.EspaceLibereMo) Mo"
$resume

Explication

Le script suit l’ordre : valider les entrées, refuser les cas dangereux, agir, journaliser, renvoyer un résumé. Resolve-Path transforme un chemin relatif en chemin absolu, ce qui rend la comparaison avec la liste des dossiers interdits fiable.

Pour aller plus loin

Amélioration possible : un paramètre -Corbeille qui déplace au lieu de supprimer, le temps de gagner en confiance.