V1-deleteDDF/README.md

Script de suppression des fichiers firmware DFF

Ce script permet de supprimer automatiquement les fichiers .DFF (firmware) sur plusieurs contrôleurs Distech Controls.

Pré-requis

• Windows 10 ou Windows 11
• Fichier CSV exporté depuis XpressNetwork Utilities

Étape 1 : Exporter la liste des contrôleurs

1. Ouvrir XpressNetwork Utilities
2. Sélectionner les contrôleurs souhaités
3. Exporter la liste en CSV

Étape 2 : Ajouter les identifiants au fichier CSV

Le fichier CSV exporté ne contient pas les identifiants de connexion. Il faut les ajouter manuellement.

1. Ouvrir le fichier CSV avec Excel ou un éditeur de texte
2. Trouver les colonnes Username et Password (dernières colonnes)
3. Remplir ces colonnes pour chaque contrôleur

Exemple :

"Username";"Password"
"admin";"MonMotDePasse"
"admin";"MonMotDePasse"

4. Enregistrer le fichier

Étape 3 : Exécuter le script

Ouvrir PowerShell dans le bon dossier

1. Ouvrir l'Explorateur de fichiers
2. Naviguer vers le dossier contenant le script et le fichier CSV
3. Maintenir la touche Shift et faire un clic droit dans le dossier (pas sur un fichier)
4. Cliquer sur "Ouvrir la fenêtre PowerShell ici" ou "Ouvrir dans le terminal"

Option A : Mode test (recommandé en premier)

Ce mode affiche les fichiers qui seraient supprimés sans les supprimer.

Copier-coller la commande suivante :

powershell -ExecutionPolicy Bypass -File delete-firmware.ps1 -CsvPath "exempleExport.csv" -DryRun

Option B : Suppression réelle

Une fois le mode test validé, exécuter sans -DryRun :

powershell -ExecutionPolicy Bypass -File delete-firmware.ps1 -CsvPath "exempleExport.csv"

Exemple complet

Si le script et le CSV sont dans le même dossier, ouvrir PowerShell dans ce dossier puis :

# Mode test
powershell -ExecutionPolicy Bypass -File delete-firmware.ps1 -CsvPath "exempleExport.csv" -DryRun

# Suppression réelle
powershell -ExecutionPolicy Bypass -File delete-firmware.ps1 -CsvPath "exempleExport.csv"

Fichier de log

Un fichier de log est créé automatiquement dans le même dossier que le CSV :

delete-firmware_2026-02-05_15-45-16.log

Ce fichier contient :

• Les contrôleurs traités
• Les fichiers supprimés
• Les erreurs rencontrées

Comprendre les résultats

Message	Signification
SUPPRIME: xxx.DFF	Fichier supprimé avec succès
[DRY-RUN] A supprimer: xxx.DFF	Fichier qui serait supprimé (mode test)
Aucun fichier DFF trouve	Pas de fichier .DFF sur ce contrôleur
ECHEC connexion	Contrôleur injoignable (vérifier IP/réseau)

Dépannage

"Impossible de se connecter au serveur distant"

• Vérifier que le contrôleur est allumé et accessible sur le réseau
• Vérifier l'adresse IP dans le fichier CSV

"Erreur 401" ou "Non autorisé"

• Vérifier le nom d'utilisateur et mot de passe dans le CSV

Le script ne se lance pas

• Vérifier que la commande commence bien par powershell -ExecutionPolicy Bypass

Support

Pour toute question, contacter le support technique.