IPv6ManagerCLI/README.md

IPv6ManagerCLI

Outil en ligne de commande pour activer ou désactiver l'IPv6 sur les interfaces réseau des automates Distech Controls Eclypse Facilities (API v2 uniquement), via leur API REST.

---

IMPORTANT : Ce projet est un développement personnel indépendant.

Ce projet a été développé par Charles-Arthur DAVID à titre personnel. Distech Controls n'est pas responsable de ce projet et ne le supporte pas. Aucune demande de support ne sera prise en charge par Distech Controls. Distech Controls ne fournit aucune garantie ni assistance technique pour ce projet.

---

Prérequis

• Windows 10 ou 11 (PowerShell 5.1 est inclus par défaut, rien à installer)
• Un accès réseau aux automates Eclypse Facilities
• Les identifiants de connexion aux automates (par défaut : admin / mot de passe vide)
• Automates compatibles API v2 (Eclypse Facilities).

Ce que fait cet outil

Pour chaque automate listé dans un CSV :

1. Récupère la liste des interfaces réseau (GET /api/rest/v2/services/platform/network/interfaces).
2. Détecte les interfaces IPv6-capables : celles possédant une section ipv6 dans leur configuration (ex : secondary, auxiliary, wireless, bridge, primary).
3. Applique l'état demandé (Enable ou Disable) sur chacune de ces interfaces (POST /api/rest/v2/services/platform/network/interfaces/{name}/ipv6 avec {"enabled": true|false}), indépendamment de leur état actuel.

En cas d'erreur sur un automate ou une interface (injoignable, échec du POST...), le script logue l'erreur, marque la ligne concernée en erreur, et continue avec l'interface/l'automate suivant.

Un CSV récapitulatif est généré à la fin, avec l'ancien et le nouvel état de chaque interface traitée.

---

Utilisation avec cadMasterCLI

Ce script peut être piloté depuis cadMasterCLI, qui évite d'avoir à utiliser PowerShell manuellement.

Quand ce script est sélectionné dans cadMasterCLI :

• Les paramètres sont détectés automatiquement et affichés sous forme de champs :
  • Action : RadioButtons Enable / Disable (valeurs du [ValidateSet], Disable sélectionné par défaut)
  • CsvInput : bouton "Parcourir" + zone de collage d'IPs (conversion automatique en CSV)
  • Username, Password : champs texte
• Il suffit de renseigner les champs puis de lancer l'exécution depuis l'interface — aucune commande PowerShell à taper, aucune politique d'exécution à modifier manuellement.

Se référer à la section suivante pour le détail des paramètres, du format du CSV attendu et du dépannage.

---

Utilisation en autonome

Vérifier que PowerShell est disponible

Ouvrir un terminal (touche Windows + R, taper powershell, puis Entrée) et taper :

$PSVersionTable.PSVersion

Le numéro Major doit être 5 ou plus.

Installation

Aucune installation requise. Télécharger ou cloner le dépôt :

IPv6ManagerCLI/ (ce dépôt)
├── IPv6ManagerCLI.ps1     <- Script principal
└── README.md

Utilisation

Ouvrir PowerShell dans le bon dossier

1. Ouvrir l'explorateur de fichiers et naviguer dans le dossier du dépôt
2. Cliquer dans la barre d'adresse, taper powershell, puis appuyer sur Entrée

Ou bien dans un terminal PowerShell :

cd "C:\chemin\vers\IPv6ManagerCLI"

Politique d'exécution

Si c'est la première fois, PowerShell peut bloquer l'exécution des scripts. Autoriser pour la session en cours :

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Cette commande est sans risque : elle n'autorise les scripts que pour la fenêtre PowerShell en cours.

Désactiver l'IPv6 (action par défaut)

.\IPv6ManagerCLI.ps1 -CsvInput ".\automates.csv"

Activer l'IPv6

.\IPv6ManagerCLI.ps1 -Action Enable -CsvInput ".\automates.csv"

Avec un mot de passe :

.\IPv6ManagerCLI.ps1 -Action Enable -CsvInput ".\automates.csv" -Password "MonMotDePasse"

Résultat : Un fichier ipv6manager_yyyy-MM-dd_HH-mm.csv est créé dans le dossier courant, avec le détail par interface (ancien état, nouvel état, statut).

Aide intégrée

Get-Help .\IPv6ManagerCLI.ps1 -Detailed

Format du CSV d'entrée

Le fichier CSV utilise le point-virgule (;) comme séparateur.

Colonnes obligatoires

Colonne	Description
Hostname	Nom de l'automate
Current Ip	Adresse IP de l'automate
HttpPort	Port HTTP (80 ou -1 si désactivé)
HttpsPort	Port HTTPS (443 ou -1 si désactivé)

Colonnes optionnelles

Colonne	Description
Username	Login spécifique à cet automate
Password	Mot de passe spécifique à cet automate

Exemple de CSV

"Hostname";"Current Ip";"HttpPort";"HttpsPort"
"ECY-BATIMENT-01";"10.60.105.42";"-1";"443"
"ECY-BATIMENT-02";"10.60.105.44";"-1";"443"

CSV de résultat

Un fichier ipv6manager_yyyy-MM-dd_HH-mm.csv est généré dans le dossier courant, avec une ligne par interface traitée :

Colonne	Description
Hostname	Nom de l'automate
IP	Adresse IP de l'automate
Interface	Nom de l'interface (secondary, auxiliary, wireless, bridge, primary...)
AncienEtat	État IPv6 avant modification (True/False)
NouvelEtat	État IPv6 appliqué (True/False)
Statut	Succes ou Erreur
Message	Détail de l'erreur si applicable

Logs

Chaque exécution affiche sa progression directement dans la console, avec un résumé final (automates traités, interfaces modifiées, interfaces en erreur).

Niveaux de log

Niveau	Couleur console	Signification
INFO	Cyan	Opération normale
OK	Vert	Opération réussie
WARN	Jaune	Avertissement (port invalide...)
ERROR	Rouge	Erreur (connexion échouée, automate injoignable...)

Résumé des paramètres

.\IPv6ManagerCLI.ps1 [-Action <Enable|Disable>] -CsvInput <chemin> [-Username <login>] [-Password <mdp>]

Paramètre	Obligatoire	Défaut	Description
-Action	Non	Disable	Enable ou Disable
-CsvInput	Oui	—	Chemin du fichier CSV d'entrée
-Username	Non	admin	Login API (surchargeable par le CSV)
-Password	Non	(vide)	Mot de passe API (surchargeable par le CSV)

Dépannage

"Impossible d'exécuter le script car l'exécution de scripts est désactivée"

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

"Aucun port HTTP/HTTPS valide"

Vérifier que les colonnes HttpPort et HttpsPort du CSV contiennent des valeurs valides. Un port à -1 signifie "désactivé". Au moins un des deux doit être actif.

Timeout ou erreur de connexion

• Vérifier que l'automate est joignable (ping 10.60.105.x)
• Vérifier les identifiants (Username / Password)
• Vérifier que le port est correct (HTTP 80 ou HTTPS 443)
• Vérifier que l'automate est bien un Eclypse Facilities compatible API v2

IPv6ManagerCLI

Command-line tool to enable or disable IPv6 on the network interfaces of Distech Controls Eclypse Facilities controllers (API v2 only), via their REST API.

---

IMPORTANT: This project is an independent personal development.

This project was developed by Charles-Arthur DAVID on a personal basis. Distech Controls is not responsible for this project and does not support it. No support requests will be handled by Distech Controls. Distech Controls provides no warranty or technical assistance for this project.

---

Prerequisites

• Windows 10 or 11 (PowerShell 5.1 is included by default, nothing to install)
• Network access to the Eclypse Facilities controllers
• Login credentials for the controllers (default: admin / empty password)
• Controllers compatible with API v2 (Eclypse Facilities).

What this tool does

For each controller listed in a CSV:

1. Retrieves the list of network interfaces (GET /api/rest/v2/services/platform/network/interfaces).
2. Detects IPv6-capable interfaces: those with an ipv6 section in their configuration (e.g. secondary, auxiliary, wireless, bridge, primary).
3. Applies the requested state (Enable or Disable) on each of these interfaces (POST /api/rest/v2/services/platform/network/interfaces/{name}/ipv6 with {"enabled": true|false}), regardless of their current state.

On error for a controller or interface (unreachable, failed POST...), the script logs the error, flags the row as an error, and continues with the next interface/controller.

A summary CSV is generated at the end, with the old and new state of each processed interface.

---

Using with cadMasterCLI

This script can be run from cadMasterCLI, which avoids having to use PowerShell manually.

When this script is selected in cadMasterCLI:

• Parameters are detected automatically and rendered as input fields:
  • Action: RadioButtons Enable / Disable (values from [ValidateSet], Disable selected by default)
  • CsvInput: a "Browse" button plus an IP paste area (automatic conversion to CSV)
  • Username, Password: text fields
• Simply fill in the fields and launch the run from the interface — no PowerShell command to type, no execution policy to change manually.

See the next section for parameter details, the expected CSV format, and troubleshooting.

---

Standalone usage

Check that PowerShell is available

Open a terminal (Windows key + R, type powershell, then Enter) and type:

$PSVersionTable.PSVersion

The Major number must be 5 or higher.

Installation

No installation required. Download or clone this repository:

IPv6ManagerCLI/ (this repo)
├── IPv6ManagerCLI.ps1     <- Main script
└── README.md

Usage

Open PowerShell in the right folder

1. Open File Explorer and navigate to the repository folder
2. Click in the address bar, type powershell, then press Enter

Or in a PowerShell terminal:

cd "C:\path\to\IPv6ManagerCLI"

Execution policy

The first time, PowerShell may block script execution. Allow it for the current session:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

This command is safe: it only allows scripts for the current PowerShell window.

Disable IPv6 (default action)

.\IPv6ManagerCLI.ps1 -CsvInput ".\controllers.csv"

Enable IPv6

.\IPv6ManagerCLI.ps1 -Action Enable -CsvInput ".\controllers.csv"

With a password:

.\IPv6ManagerCLI.ps1 -Action Enable -CsvInput ".\controllers.csv" -Password "MyPassword"

Result: A file ipv6manager_yyyy-MM-dd_HH-mm.csv is created in the current folder, with per-interface detail (old state, new state, status).

Built-in help

Get-Help .\IPv6ManagerCLI.ps1 -Detailed

Input CSV format

The CSV file uses a semicolon (;) as separator.

Required columns

Column	Description
Hostname	Controller name
Current Ip	Controller IP address
HttpPort	HTTP port (80 or -1 if disabled)
HttpsPort	HTTPS port (443 or -1 if disabled)

Optional columns

Column	Description
Username	Login specific to this controller
Password	Password specific to this controller

CSV example

"Hostname";"Current Ip";"HttpPort";"HttpsPort"
"ECY-BUILDING-01";"10.60.105.42";"-1";"443"
"ECY-BUILDING-02";"10.60.105.44";"-1";"443"

Result CSV

A file ipv6manager_yyyy-MM-dd_HH-mm.csv is generated in the current folder, with one row per processed interface:

Column	Description
Hostname	Controller name
IP	Controller IP address
Interface	Interface name (secondary, auxiliary, wireless, bridge, primary...)
AncienEtat	IPv6 state before the change (True/False)
NouvelEtat	Applied IPv6 state (True/False)
Statut	Succes or Erreur
Message	Error detail if applicable

Logs

Each run displays its progress directly in the console, with a final summary (controllers processed, interfaces changed, interfaces in error).

Log levels

Level	Console color	Meaning
INFO	Cyan	Normal operation
OK	Green	Successful operation
WARN	Yellow	Warning (invalid port...)
ERROR	Red	Error (connection failed, controller unreachable...)

Parameters summary

.\IPv6ManagerCLI.ps1 [-Action <Enable|Disable>] -CsvInput <path> [-Username <login>] [-Password <password>]

Parameter	Required	Default	Description
-Action	No	Disable	Enable or Disable
-CsvInput	Yes	—	Path to the input CSV file
-Username	No	admin	API login (overridable by the CSV)
-Password	No	(empty)	API password (overridable by the CSV)

Troubleshooting

"Cannot run the script because script execution is disabled"

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

"No valid HTTP/HTTPS port"

Check that the CSV's HttpPort and HttpsPort columns contain valid values. A port set to -1 means "disabled". At least one of the two must be active.

Timeout or connection error

• Check that the controller is reachable (ping 10.60.105.x)
• Check the credentials (Username / Password)
• Check that the port is correct (HTTP 80 or HTTPS 443)
• Check that the controller is an Eclypse Facilities unit compatible with API v2