Fichiers, CSV et JSON : Import-Csv, ConvertFrom-Json et jq

Un script d'administration passe son temps à lire et à écrire des fichiers : des journaux en texte brut, des listes de comptes en CSV (des valeurs séparées par un délimiteur, une ligne par enregistrement) et des configurations ou des réponses d'API en JSON (des objets imbriqués écrits en texte). PowerShell transforme directement un CSV ou un JSON en objets ; Bash les traite avec cut, awk et l'outil jq. Ce chapitre montre les deux approches, et les pièges d'encodage et de délimiteur qui font perdre des heures.

Les chemins et les fichiers en PowerShell

Chaque fichier renvoyé par Get-ChildItem est un objet avec Name, FullName, Length (la taille en octets), LastWriteTime, Extension. Les fichiers de plus de 30 jours d'un dossier de journaux, avec leur taille en Mo :

$limite = (Get-Date).AddDays(-30)
Get-ChildItem -Path 'C:\Scripts\Logs' -File |
    Where-Object LastWriteTime -lt $limite |
    Select-Object Name, LastWriteTime, @{ Name = 'TailleMo'; Expression = { [math]::Round($_.Length / 1MB, 2) } }

Lire et écrire du texte

$lignes = Get-Content -Path 'C:\Scripts\serveurs.txt'        # un tableau, une ligne par élément
$texte  = Get-Content -Path 'C:\Scripts\config.json' -Raw    # une seule chaîne, sauts de ligne compris
Get-Content -Path 'C:\Scripts\Logs\export.log' -Tail 20      # les 20 dernières lignes
Get-Content -Path 'C:\Scripts\Logs\export.log' -Wait         # suivre le fichier en direct, comme tail -f

Set-Content -Path rapport.txt -Value 'Première ligne' -Encoding UTF8   # remplace le contenu
Add-Content -Path rapport.txt -Value 'Ligne ajoutée' -Encoding UTF8    # ajoute à la fin

Les fichiers CSV avec Import-Csv et Export-Csv

Un CSV a une première ligne d'en-têtes, puis une ligne par enregistrement. Le délimiteur est souvent le point-virgule en France, car Excel en français utilise la virgule comme séparateur décimal. Voici postes.csv, l'inventaire simplifié de quelques postes de Sorbier :

Nom;Service;OS;RAMGo
PC-0001;Comptabilite;Windows 11;16
PC-0002;Commercial;Windows 10;8
PC-0003;Comptabilite;Windows 11;8
PC-0004;Logistique;Windows 10;4
PC-0005;Direction;Windows 11;32
PC-0006;Logistique;Windows 11;16

Import-Csv transforme chaque ligne en objet dont les propriétés portent le nom des colonnes :

$postes = Import-Csv -Path .\postes.csv -Delimiter ';' -Encoding UTF8
$postes | Where-Object OS -eq 'Windows 10'

Nom     Service    OS         RAMGo
---     -------    --         -----
PC-0002 Commercial Windows 10 8
PC-0004 Logistique Windows 10 4

$postes | Group-Object OS | Select-Object Name, Count

Name       Count
----       -----
Windows 11     4
Windows 10     2

Windows 10 n'est plus maintenu depuis le 14 octobre 2025 : ces deux postes sont à migrer. Cette liste est exactement ce que l'on joint à une demande de budget.

Pour écrire un CSV, on envoie des objets à Export-Csv :

$postes | Where-Object OS -eq 'Windows 10' |
    Select-Object Nom, Service |
    Export-Csv -Path .\a-migrer.csv -Delimiter ';' -NoTypeInformation -Encoding UTF8

• -NoTypeInformation évite, dans Windows PowerShell 5.1, une première ligne #TYPE System.Management.Automation.PSCustomObject qui perturbe Excel. PowerShell 7 ne l'écrit plus par défaut ; le paramètre ne fait pas de mal.
• -Delimiter ';' produit un fichier qu'Excel en français ouvre directement en colonnes. -UseCulture prend le séparateur des réglages régionaux de la machine.
• Pour qu'Excel affiche correctement les accents, le fichier doit avoir un BOM : -Encoding UTF8 en 5.1, -Encoding utf8BOM en 7.
• -Append ajoute des lignes à un CSV existant, à condition que les colonnes soient les mêmes.

ConvertFrom-Csv et ConvertTo-Csv font la même chose sur du texte en mémoire, sans fichier : pratique pour traiter la sortie d'un ancien programme qui écrit du CSV, comme schtasks /query /fo csv.

Les fichiers JSON

Le JSON (JavaScript Object Notation) représente des objets imbriqués : des paires "clé": valeur entre accolades, des listes entre crochets. C'est le format des API REST (chapitre 10) et un bon format de configuration pour un script. Voici config.json, à côté du script de surveillance des disques :

{
  "seuilAttention": 15,
  "seuilCritique": 10,
  "serveurs": ["srv-ad", "srv-ad2", "srv-fichiers"],
  "alerte": { "destinataire": "informatique@sorbier.example" }
}

$config = Get-Content -Path (Join-Path $PSScriptRoot 'config.json') -Raw | ConvertFrom-Json
$config.seuilCritique            # 10
$config.serveurs[1]              # srv-ad2
$config.alerte.destinataire      # informatique@sorbier.example

-Raw est indispensable : sans lui, Get-Content envoie les lignes une par une. Contrairement à un CSV, le JSON garde les types : seuilCritique est bien un nombre.

Dans l'autre sens, ConvertTo-Json transforme des objets en texte JSON :

[pscustomobject]@{ Serveur = 'srv-ad'; LibreGo = 31; Lecteurs = @('C', 'D') } | ConvertTo-Json

{
  "Serveur": "srv-ad",
  "LibreGo": 31,
  "Lecteurs": [
    "C",
    "D"
  ]
}

C'est la sortie de PowerShell 7, indentée de deux espaces ; Windows PowerShell 5.1 indente autrement, avec le même contenu. -Compress écrit tout sur une ligne : {"Serveur":"srv-ad","LibreGo":31,"Lecteurs":["C","D"]}.

Le texte et les CSV en Bash

Les outils Linux traitent du texte ligne par ligne. Sur le même postes.csv :

cut -d';' -f1,3 postes.csv                       # colonnes 1 et 3
tail -n +2 postes.csv                            # tout sauf la première ligne (l'en-tête)
awk -F';' '$3 == "Windows 10" { print $1 " (" $2 ")" }' postes.csv

PC-0002 (Commercial)
PC-0004 (Logistique)

awk est le couteau suisse des fichiers en colonnes : -F';' fixe le séparateur, $1, $2… désignent les colonnes, NR le numéro de ligne, et un bloc END s'exécute à la fin. Compter les postes par système, et additionner la mémoire :

awk -F';' 'NR > 1 { n[$3]++ } END { for (os in n) print os ": " n[os] }' postes.csv | sort
awk -F';' 'NR > 1 { total += $4 } END { print total " Go" }' postes.csv

Windows 10: 2
Windows 11: 4
84 Go

L'enchaînement sort | uniq -c | sort -rn compte les occurrences d'une valeur et les classe de la plus fréquente à la moins fréquente. uniq ne regroupe que des lignes voisines, d'où le premier sort :

tail -n +2 postes.csv | cut -d';' -f2 | sort | uniq -c | sort -rn

      2 Logistique
      2 Comptabilite
      1 Direction
      1 Commercial

À égalité de nombre, sort -rn classe les lignes entières dans l'ordre inverse, d'où Logistique avant Comptabilite.

Le JSON en Bash avec jq

Bash ne sait pas lire le JSON. L'outil jq, à installer (sudo apt install jq : Debian 13 fournit jq 1.7.1), le filtre et le transforme. Avec le config.json ci-dessus :

jq '.seuilCritique' config.json            # 10
jq -r '.alerte.destinataire' config.json   # informatique@sorbier.example
jq -r '.serveurs[]' config.json            # une ligne par serveur
jq '.serveurs | length' config.json        # 3

L'option -r (raw) affiche les chaînes sans leurs guillemets : indispensable pour utiliser le résultat dans une variable Bash. Sans elle, jq '.alerte.destinataire' affiche "informatique@sorbier.example", guillemets compris.

Sur une liste d'objets, comme postes.json :

[
  { "nom": "PC-0002", "service": "Commercial", "os": "Windows 10", "ramGo": 8 },
  { "nom": "PC-0005", "service": "Direction", "os": "Windows 11", "ramGo": 32 },
  { "nom": "PC-0004", "service": "Logistique", "os": "Windows 10", "ramGo": 4 }
]

jq -r '.[] | select(.os == "Windows 10") | .nom' postes.json        # PC-0002 puis PC-0004
jq '[.[] | select(.ramGo >= 8)] | length' postes.json               # 2
jq -r '.[] | "\(.nom);\(.service)"' postes.json                     # une ligne CSV par poste
jq -r --arg os "Windows 11" '.[] | select(.os == $os) | .nom' postes.json   # PC-0005

Passe toujours une valeur du shell par --arg plutôt qu'en la collant dans le filtre : une valeur contenant un guillemet casserait le filtre, comme une injection.

Exercices

# 1.
@($postes | Where-Object Service -eq 'Comptabilite').Count
# 2.
$postes | Where-Object { [int]$_.RAMGo -lt 16 }
# 3.
($postes | Measure-Object -Property RAMGo -Sum).Sum
# 4.
$postes | Where-Object Service -eq 'Logistique' |
    Export-Csv -Path .\logistique.csv -Delimiter ';' -NoTypeInformation -Encoding utf8BOM

awk -F';' 'NR > 1 && $4 >= 16 { print $1 }' postes.csv
tail -n +2 postes.csv | cut -d';' -f2 | sort | uniq -c | sort -rn

PC-0001
PC-0005
PC-0006

$config = Get-Content -Path .\config.json -Raw | ConvertFrom-Json
$second = $config.serveurs[1]
foreach ($s in $config.serveurs) { "Contrôle de $s" }

second=$(jq -r '.serveurs[1]' config.json)
jq -r '.serveurs[]' config.json | while IFS= read -r s; do
    echo "Contrôle de $s"
done

Get-ADUser -Filter * -Properties Department | Select-Object Name, Department |
    Export-Csv -Path annuaire.csv -Delimiter ';' -NoTypeInformation -Encoding UTF8