Leer y escribir CSV con PowerShell

El CSV es el idioma común entre Excel, los sistemas de ventas y casi cualquier programa. PowerShell lo convierte en objetos con Import-Csv, así que filtrar, unir, agrupar y sumar es cuestión de unas líneas, y con Export-Csv lo devuelves listo para abrir en Excel.

Dos archivos de un sistema de ventas: clientes.csv, exportado de un Excel configurado con punto y coma, y pedidos.csv, con comas:

id;nombre;ciudad
1;Ana López;Puebla
2;Luis Pérez;Mérida
3;Marta Ruiz;Monterrey
pedido,cliente,fecha,importe
1001,1,2026-11-02,1299.00
1002,2,2026-11-03,349.50
1003,1,2026-11-05,5899.00
1004,3,2026-11-06,159.00
1005,2,2026-11-06,18499.00

Leer: Import-Csv

$clientes = Import-Csv -Path clientes.csv -Delimiter ";"
$pedidos = Import-Csv -Path pedidos.csv
$clientes | Format-Table
$pedidos[0]
$pedidos[0].importe.GetType().Name
salidaid nombre     ciudad
-- ------     ------
1  Ana López  Puebla
2  Luis Pérez Mérida
3  Marta Ruiz Monterrey

pedido cliente fecha      importe
------ ------- -----      -------
1001   1       2026-11-02 1299.00
String

Cada renglón se convierte en un objeto con una propiedad por columna. -Delimiter indica el separador cuando no es la coma. Y lo más importante: todo llega como texto, también el importe. Para sumar, comparar u ordenar números hay que convertirlos.

Convertir los tipos una vez, al leer

$pedidos = Import-Csv -Path pedidos.csv | ForEach-Object {
    [pscustomobject]@{
        Pedido  = [int]$_.pedido
        Cliente = [int]$_.cliente
        Fecha   = [datetime]::ParseExact($_.fecha, "yyyy-MM-dd", $null)
        Importe = [decimal]$_.importe
    }
}
$pedidos | Sort-Object Importe -Descending | Select-Object -First 2 Pedido, @{ Name = "Importe"; Expression = { $_.Importe.ToString("N2") } }
"Total vendido: {0:N2}" -f ($pedidos | Measure-Object Importe -Sum).Sum
salidaPedido Importe
------ -------
  1005 18,499.00
  1003 5,899.00
Total vendido: 26,205.50

Para mostrar el importe con dos decimales y separador de miles, se formatea con .ToString("N2") al final, solo para la pantalla. [decimal] es el tipo indicado para dinero: no tiene los errores de redondeo de [double]. Con la fecha como [datetime] se puede filtrar por día de la semana o por mes.

Unir dos CSV: el BUSCARV de PowerShell

$clientes = @{}
Import-Csv -Path clientes.csv -Delimiter ";" | ForEach-Object { $clientes[$_.id] = $_ }

Import-Csv -Path pedidos.csv | ForEach-Object {
    $c = $clientes[$_.cliente]
    [pscustomobject]@{
        Pedido  = $_.pedido
        Cliente = $c.nombre
        Ciudad  = $c.ciudad
        Importe = [decimal]$_.importe
    }
} | Group-Object Cliente | ForEach-Object {
    [pscustomobject]@{
        Cliente = $_.Name
        Pedidos = $_.Count
        Total   = ($_.Group | Measure-Object Importe -Sum).Sum
    }
} | Sort-Object Total -Descending | Export-Csv -Path resumen.csv -NoTypeInformation -Encoding utf8BOM

Get-Content resumen.csv
salida"Cliente","Pedidos","Total"
"Luis Pérez","2","18848.5"
"Ana López","2","7198"
"Marta Ruiz","1","159"

La hashtable $clientes guarda cada cliente por su id, así que encontrarlo es inmediato aunque haya miles: es lo que hace BUSCARV en Excel, pero sin fórmulas. Después se agrupa por cliente y se exporta.

Escribir para Excel

  • -Encoding utf8BOM: con la marca BOM, Excel en Windows reconoce el UTF-8 y muestra bien «Pérez». Sin ella, puede salir «Pérez».
  • -NoTypeInformation: en Windows PowerShell 5.1 evita una primera línea #TYPE. En PowerShell 7 ya no hace falta, pero no estorba.
  • -UseCulture: usa el separador de listas de tu Windows (coma en México, punto y coma en España). O fíjalo con -Delimiter ";".
  • PowerShell 7 pone comillas a todos los campos; con -UseQuotes AsNeeded solo las pone donde hacen falta.
Import-Csv -Path pedidos.csv | Select-Object -First 2 | ConvertTo-Csv -UseQuotes AsNeeded -Delimiter ";"
salidapedido;cliente;fecha;importe
1001;1;2026-11-02;1299.00
1002;2;2026-11-03;349.50

ConvertTo-Csv hace lo mismo que Export-Csv pero devuelve el texto en lugar de escribir un archivo. Para leer y escribir archivos .xlsx de verdad, con hojas y formato, sin tener Excel instalado, existe el módulo comunitario ImportExcel (Install-PSResource ImportExcel).

Todos los scripts de esta página se ejecutaron con PowerShell 7.6.10 (LTS) en un contenedor Linux limpio sin acceso a la red, con la configuración regional de México, y pasaron PSScriptAnalyzer 1.25 sin avisos antes de publicarla; las salidas están copiadas de esa ejecución. Por eso las rutas salen como /home/ana/proyecto; en Windows verás algo como C:\Users\ana.