# 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
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
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 :

```powershell
# 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.