108 lines
3.1 KiB
Markdown
108 lines
3.1 KiB
Markdown
# 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.
|