Le blog technique

Toutes les astuces #tech des collaborateurs de PI Services.

#openblogPI

Retrouvez les articles à la une

[PowerShell] Gestion des erreurs avec Try / Catch

PowerShell est largement utilisé pour automatiser des tâches d’administration système, aussi bien en local que sur des serveurs ou dans des environnements cloud (Azure Automation, pipelines CI/CD, tâches planifiées).
Dans ces contextes, un script qui “semble” fonctionner peut pourtant masquer des erreurs critiques, conduisant à des résultats partiels, incohérents, voire dangereux.

La gestion des erreurs devient alors un élément central de la fiabilité des scripts PowerShell.

Problématique rencontrée

Lors de l’exécution de plusieurs scripts automatisés, certaines commandes échouaient sans interrompre le script.
Aucune alerte claire n’était remontée, et l’exécution se terminait avec succès, alors que certaines actions n’avaient jamais été effectuées.

Les symptômes étaient typiques :

  • aucune interruption du script
  • aucune gestion centralisée des erreurs
  • résultats incomplets ou faux positifs
  • difficulté à diagnostiquer a posteriori

PowerShell distingue principalement deux catégories d’erreurs, avec des comportements très différents.

Erreurs non bloquantes (Non-terminating errors)

Ce sont les erreurs les plus courantes.
Par défaut, PowerShell affiche l’erreur à l’écran mais continue l’exécution du script.

Exemples :

  • objet introuvable
  • accès refusé
  • commande partiellement invalide

Ces erreurs ne déclenchent pas un Catch.

Erreurs bloquantes (Terminating errors)

Ces erreurs interrompent immédiatement l’exécution du script et déclenchent automatiquement un Catch.

Exemples :

  • cmdlet critique en échec
  • erreur levée manuellement
  • erreur forcée via configuration

Le rôle clé de -ErrorAction

Le paramètre -ErrorAction permet de contrôler le comportement des erreurs.

Valeurs principales de -ErrorAction :

  • Continue (par défaut)
    Affiche l’erreur et poursuit l’exécution.
  • SilentlyContinue
    Ignore l’erreur sans affichage (dangereux en automatisation).
  • Stop
    Transforme une erreur non bloquante en erreur bloquante.
  • Ignore
    Ignore totalement l’erreur (rarement recommandé).
  • Inquire
    Demande une confirmation interactive (peu adapté à l’automatisation).

Un piège courant consiste à utiliser Try / Catch sans forcer les erreurs à être bloquantes.

Try {
    Get-ADUser -Identity "UserInexistant"
}
Catch {
    Write-Host "Erreur détectée: $($_.Exception.Message)"
}

Dans ce cas :

  • l’erreur s’affiche
  • le script continue
  • le Catch n’est jamais exécuté

Bonne pratique : combiner Try / Catch et -ErrorAction Stop

Try {
    Get-ADUser -Identity "UserInexistant" -ErrorAction Stop
}
Catch {
    Write-Host "Erreur détectée: $($_.Exception.Message)"
}

Toute erreur est :

  • interceptée
  • traitée
  • journalisée proprement

[REX] DistinguishedName incorrect : comprendre, diagnostiquer et corriger

Dans de nombreux scripts PowerShell Active Directory, le DistinguishedName (DN) est utilisé comme point d’entrée pour cibler des objets précis : utilisateurs, ordinateurs ou unités d’organisation. Il est courant de récupérer un DN une première fois, puis de le réutiliser tel quel dans des scripts automatisés ou des tâches planifiées.

Ce fonctionnement semble fiable, mais il devient rapidement fragile dans des environnements Active Directory vivants, où les OU sont régulièrement déplacées, renommées ou restructurées.

Problème rencontré

Plusieurs scripts d’audit ou d’administration ne retournaient aucun résultat, ou échouaient partiellement sans générer d’erreur explicite.
Dans certains cas, les mêmes scripts fonctionnaient parfaitement sur un domaine, mais pas sur un autre.

Le comportement était trompeur : aucune exception PowerShell, aucun message d’erreur AD, simplement zéro objet retourné.

Analyse

Après investigation, les causes les plus fréquentes étaient :

  • un DistinguishedName mal formé (virgule manquante, casse incorrecte)
  • une OU déplacée ou renommée
  • un DN codé en dur devenu obsolète
  • une OU supprimée puis recréée (DN identique visuellement, mais objet différent)
  • une différence de structure entre environnements (prod / préprod)

Active Directory ne valide pas toujours explicitement un DN incorrect : la requête est acceptée, mais ne retourne aucun résultat, ce qui complique fortement le diagnostic.

Exemples concrets

Get-ADUser -SearchBase "OU=Users,OU=IT,DC=corp,DC=contoso,DC=com" -Filter *

Échoue silencieusement si l’OU est déplacée ou renommée car le DN est codé en dur.

$OU = Get-ADOrganizationalUnit -LDAPFilter "(ou=Users)" -SearchBase "DC=corp,DC=contoso,DC=com"
Get-ADUser -SearchBase $OU.DistinguishedName -Filter *

Le script s’adapte automatiquement à l’arborescence réelle car le DN est dynamique.

[Active Directory] Rechercher efficacement des objets AD avec LDAPFilter

Lors d’audits Active Directory, la recherche d’objets via PowerShell est une opération critique.
Les cmdlets telles que Get-ADUser, Get-ADComputer ou Get-ADObject proposent le paramètre -Filter, souvent suffisant pour des requêtes simples. Cependant, dès que les critères se complexifient, ce mode de filtrage montre rapidement ses limites.

Dans plusieurs scripts d’audit, certaines recherches retournaient un volume excessif d’objets, tandis que d’autres ne renvoyaient aucun résultat sans erreur explicite. Ces comportements étaient dus à des filtres trop permissifs, mal interprétés, ou difficiles à maintenir lorsque plusieurs conditions entraient en jeu.

L’utilisation des filtres LDAP via le paramètre -LDAPFilter s’est alors révélée être une solution plus robuste. Les filtres LDAP sont interprétés nativement par Active Directory, ce qui garantit une meilleure précision et des performances supérieures, notamment dans des environnements de grande taille.

Exemples concrets

Get-ADUser -LDAPFilter "(&(objectClass=user)(employeeID=*)(!(userAccountControl:1.2.840.113556.1.4.803:=2)))"

Cela retourne uniquement les comptes utilisateurs activés disposant d’un EmployeeID.

Get-ADUser -LDAPFilter "(&(objectClass=user)(servicePrincipalName=*))"

Très efficace pour détecter les comptes exposés à des risques de type Kerberoasting.