4. Script prêt à planifier

• Transformer un script interactif (Read-Host) en script paramétrable
• Exécuter sans interaction (ligne de commande / planification)
• Produire une sortie exploitable : rapport + logs
• Connaître les points clés du Planificateur Windows

Pourquoi paramétrer un script ?

Un script planifié doit pouvoir s’exécuter sans écran, sans intervention, et sans question à l’utilisateur. On remplace donc Read-Host par des paramètres (bloc param(...)).

Exemple : organisation par extension (version paramétrée)

Objectif : reprendre la logique du chapitre 3, mais sans Read-Host, avec paramètres et gestion d’erreurs.

param(
  [Parameter(Mandatory=$true)]
  [string]$SourceDir,

  [ValidateSet("Audit","Action")]
  [string]$Mode = "Audit"
)

# =========================
# Contrôles
# =========================
if (-not (Test-Path $SourceDir)) {
  Write-Output "Dossier introuvable : $SourceDir"
  exit 1
}

# =========================
# Sorties : rapport + log
# =========================
$reportPath = Join-Path $SourceDir "report.txt"
$logPath    = Join-Path $SourceDir "script.log"

function Write-Log {
  param(
    [string]$Message,
    [ValidateSet("INFO","WARN","ERROR")][string]$Level = "INFO"
  )
  $ts = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
  Add-Content -Path $logPath -Value "$ts [$Level] $Message"
}

"RAPPORT - Organisation du dossier : $SourceDir" | Out-File $reportPath -Encoding UTF8
Write-Log "Démarrage - Mode=$Mode - Source=$SourceDir"

# =========================
# Traitement avec gestion d’erreurs
# =========================
try {
  $files = Get-ChildItem -Path $SourceDir -File |
    Where-Object { $_.Name -notin @("report.txt","script.log") }

  foreach ($f in $files) {
    $ext = $f.Extension
    if ([string]::IsNullOrWhiteSpace($ext)) { $ext = "SANS_EXTENSION" }
    else { $ext = $ext.TrimStart(".").ToUpper() }

    $targetDir = Join-Path $SourceDir $ext
    if (-not (Test-Path $targetDir)) {
      if ($Mode -eq "Action") {
        New-Item -ItemType Directory -Path $targetDir -ErrorAction Stop | Out-Null
        Write-Log "Création dossier : $targetDir"
      } else {
        Write-Log "AUDIT - Dossier à créer : $targetDir"
      }
    }

    $destPath = Join-Path $targetDir $f.Name

    if ($Mode -eq "Action") {
      Move-Item -Path $f.FullName -Destination $destPath -ErrorAction Stop
      Add-Content -Path $reportPath -Value ("DEPLACE : {0} -> {1}" -f $f.Name, $ext)
      Write-Log "Déplacement : $($f.Name) -> $ext"
    } else {
      Add-Content -Path $reportPath -Value ("AUDIT : {0} -> {1}" -f $f.Name, $ext)
      Write-Log "AUDIT - Déplacement prévu : $($f.Name) -> $ext"
    }
  }

  Write-Log "Fin - OK"
  Write-Output "OK - Rapport : $reportPath"
  exit 0
}
catch {
  Write-Log "Erreur : $($_.Exception.Message)" "ERROR"
  Write-Output "ERREUR : $($_.Exception.Message)"
  exit 2
}

Exécuter sans interaction (CLI)

# Mode Audit
powershell.exe -ExecutionPolicy Bypass -File .\organize.ps1 -SourceDir "C:\Temp\source" -Mode Audit

# Mode Action
powershell.exe -ExecutionPolicy Bypass -File .\organize.ps1 -SourceDir "C:\Temp\source" -Mode Action

Configurer une tâche planifiée (Task Scheduler)

Exemple : exécuter chaque jour à 08:00 un script de rangement en mode audit.

powershell.exe

-ExecutionPolicy Bypass -File "C:\Scripts\organize.ps1" -SourceDir "C:\Temp\source" -Mode Audit

C:\Scripts

Planifier l’exécution d’un script avec le Planificateur de tâches (Windows)

Ce guide vous explique comment créer une tâche planifiée pour exécuter un script PowerShell sans interaction, de manière fiable et traçable.

Étape 1 — Tester la commande manuellement

Avant toute planification, validez que la commande fonctionne dans un terminal PowerShell.

powershell.exe -ExecutionPolicy Bypass -File "C:\Scripts\organize.ps1" -SourceDir "C:\Temp\source" -Mode Audit

Étape 2 — Ouvrir le Planificateur de tâches

1. Menu Démarrer → recherchez Planificateur de tâches (Task Scheduler)
2. Ouvrez l’outil (idéalement en administrateur si nécessaire)

Étape 3 — Créer une tâche (recommandé)

1. Dans le volet droit : cliquez sur Créer une tâche… (plutôt que « Créer une tâche de base »)
2. Onglet Général :
   • Nom : ex. PS_Organize_Audit
   • Exécuter que l’utilisateur soit connecté ou non (si besoin)
   • Exécuter avec les autorisations maximales (si votre script nécessite des droits élevés)

Étape 4 — Déclencheur (quand exécuter ?)

1. Onglet Déclencheurs → Nouveau…
2. Choisissez : Quotidien / Hebdomadaire / Au démarrage selon le besoin
3. Définissez l’heure (ex. 08:00) puis validez

Étape 5 — Action (comment exécuter ?)

L’action doit lancer powershell.exe avec les bons arguments.

powershell.exe

-ExecutionPolicy Bypass -NoProfile -File "C:\Scripts\organize.ps1" -SourceDir "C:\Temp\source" -Mode Audit

C:\Scripts

Étape 6 — Conditions & paramètres

• Onglet Conditions : désactivez les contraintes inutiles (ex. « uniquement sur secteur ») si ce n’est pas votre cas.
• Onglet Paramètres : cochez « Exécuter la tâche dès que possible après un démarrage manqué » (utile).

Étape 7 — Tester la tâche

1. Sélectionnez la tâche dans la bibliothèque
2. Cliquez sur Exécuter
3. Vérifiez :
   • le code de résultat (colonne « Résultat de la dernière exécution »)
   • les fichiers report.txt et script.log

Étape 8 — Diagnostic en cas d’échec (réflexes TSSR)

• Vérifiez les droits du compte exécutant sur $SourceDir (lecture/écriture).
• Vérifiez les guillemets : les chemins contenant des espaces doivent être entre " ".
• Activez l’Historique de la tâche pour voir les événements (bibliothèque → clic droit → Historique).
• Ajoutez des logs dans le script (déjà conseillé) et consultez script.log.

Exercices guidés (planification)

Corrigés masqués. Cherchez avant d’ouvrir.

param(
  [Parameter(Mandatory=$true)][string]$SourceDir,
  [ValidateSet("Audit","Action")][string]$Mode="Audit",
  [string]$LogDir
)

if ($LogDir) {
  if (-not (Test-Path $LogDir)) { New-Item -ItemType Directory -Path $LogDir | Out-Null }
  $logPath = Join-Path $LogDir "script.log"
} else {
  $logPath = Join-Path $SourceDir "script.log"
}

if ($files.Count -eq 0) {
  Write-Log "Aucun fichier à traiter" "WARN"
  exit 3
}

Parce que la tâche planifiée n'exécute pas forcément le script depuis son dossier.
Sans "Démarrer dans", un chemin relatif .\ressources\... peut pointer vers un autre dossier
et provoquer un "fichier introuvable".