Cómo exportar datos a archivos CSV con PowerShell

¿Quieres exportar datos de PowerShell a archivos CSV? No es algo que hagas cada cinco minutos, pero cuando necesitas un informe rápido o simplemente quieres registrar información, el cmdlet Export-CSV es la solución. La verdad es que es un poco raro lo sencillo que es, pero esos archivos CSV pueden complicarse si no tienes cuidado, como encabezados faltantes o delimitadores incorrectos. Normalmente, he visto gente que ejecuta un comando y olvida configurar la codificación o el delimitador correctos, lo que genera dolores de cabeza al abrir los archivos en Excel más tarde. Por eso, conviene saber qué opciones ajustar para que los datos se muestren correctamente a la primera y se mantengan legibles. También es muy práctico poder anexar filas en lugar de sobrescribirlas, perfecto para scripts programados que registran datos continuos como espacio en disco o listas de procesos. Una vez que le coges el truco, exportar información del sistema o cualquier otro dato tabular se vuelve mucho más rápido y menos frustrante.

Cómo exportar datos a archivos CSV mediante PowerShell

Método 1: Exportación básica de la lista de servicios

Este es el ejemplo clásico: desea obtener una lista rápida de sus servicios de Windows, con sus nombres, nombres para mostrar y estados. Es útil para auditorías o resolución de problemas. El comando convierte los objetos en cadenas separadas por comas y luego los escribe en un archivo CSV. Si no especifica el indicador -NoTypeInformation, obtendrá un archivo bastante grande que incluye información sobre el tipo de objeto, lo cual a veces es innecesario y simplemente un desorden.

Get-Service | Select-Object Name, DisplayName, Status | Export-CSV "C:\PS\services.csv" -NoTypeInformation -Encoding UTF8

En algunas configuraciones, esto funciona perfectamente a la primera, pero si al abrir el archivo en Excel observa un formato extraño, revise el delimitador. El valor predeterminado es la coma, pero si su configuración regional usa punto y coma como separadores (como muchas configuraciones regionales europeas), los datos podrían aparecer comprimidos o desordenados. En ese caso, puede especificar un delimitador diferente, como punto y coma, con el parámetro -Delimiter :

Get-Service | Export-Csv "C:\PS\services.csv" -NoTypeInformation -Encoding UTF8 -Delimiter ";"

Y si está tratando con configuraciones regionales, PowerShell puede respetar aquellas con el indicador -UseCulture, así que no se preocupe por cambiar manualmente los delimitadores en la mayoría de los casos:

Get-Process | Export-Csv "c:\ps\process.csv" -UseCulture

Para verificar cuál es su separador predeterminado, ejecute:

(Get-Culture).TextInfo. ListSeparator

Muestra su separador regional, probablemente una coma o un punto y coma. Es bueno tenerlo en cuenta al compartir o analizar archivos CSV exportados.

Método 2: Anexar datos en registros en curso

Si ejecuta scripts que generan datos periódicamente (como espacio libre en disco, estadísticas de red o cuentas de usuario), probablemente quiera agregar datos a un CSV existente. Ahí es donde entra en juego «-Append». PowerShell sobrescribe los archivos de forma predeterminada, pero con «-Append», puede seguir agregando nuevas filas sin perder la información anterior.

$cur_time = get-date -Format u $disks = Get-CimInstance -Class Win32_LogicalDisk | Where-Object { $_. DeviceID -eq "C:" } | Select-Object DeviceID, FreeSpace $disks | Add-Member -MemberType NoteProperty -Name Date -Value $cur_time $disks | Export-Csv -Path "C:\ps\freespace.csv" -Delimiter ";" -NoTypeInformation -Append 

Básicamente, agrega una marca de tiempo actual al objeto de información del disco y la adjunta al CSV. Resulta útil para crear registros continuos, como el historial de uso del disco o la actividad del usuario, al ejecutarse las tareas programadas.

Ajustes y opciones adicionales

• Codificación : Normalmente uso UTF8. Mantiene la compatibilidad, especialmente al trabajar con caracteres especiales.
• -Forzar : use esto si está sobrescribiendo un archivo de solo lectura y no desea errores.
• -NoClobber : evita que sobrescribas accidentalmente archivos existentes.
• -Encabezado : agregue encabezados personalizados si es necesario, especialmente al fusionar archivos o limpiar datos.
• -IncludeTypeInformation/-NoTypeInformation : le indica a PowerShell que incluya u omita la línea #TYPE en el CSV; resulta útil si se importa a otras herramientas.
• -UseQuotes : introducido en PowerShell Core 7.x, controla si los valores se citan o no, lo que puede evitar la corrupción de datos si los campos contienen comas o comillas.

Esa última parte puede salvarte de todo tipo de pesadillas de análisis de CSV.

Probar la exportación CSV para diferentes informes

Desde auditar equipos remotos en Active Directory y registrar las horas de inicio de sesión hasta exportar el historial de conexiones RDP, la exportación de PowerShell facilita todo. Por ejemplo, podría exportar la información del equipo de AD con:

Get-ADComputer -Filter * | Select-Object Name, OperatingSystem, LastLogonDate | Export-CSV "C:\PS\ad_computers.csv" -NoTypeInformation

O bien, puede obtener registros de actividad del usuario, según sus módulos y permisos. La clave es ajustar el comando a sus fuentes de datos.