Archivos de configuración, respuestas de APIs, exportaciones de otros programas: JSON está en todas partes. PowerShell lo convierte en objetos con ConvertFrom-Json y de vuelta con ConvertTo-Json, con un par de detalles que conviene conocer para no perder datos.
También te puede interesar
Un archivo de configuración típico, config.json:
{
"app": "inventario",
"version": "2.1",
"debug": false,
"puertos": [8080, 8443],
"base": { "servidor": "db.example.com", "usuario": "lectura", "tiempo": 30 }
}Leer: ConvertFrom-Json
$config = Get-Content -Path config.json -Raw | ConvertFrom-Json $config.app $config.puertos -join ", " $config.base.servidor $config.debug.GetType().Name $config.base.tiempo + 15
salidainventario 8080, 8443 db.example.com Boolean 45
Hay que leer con -Raw, para que ConvertFrom-Json reciba el texto entero y no línea por línea. Los tipos de JSON se respetan: false llega como Boolean y 30 como número, así que se puede operar directamente.
Cambiar y guardar
$config = Get-Content -Path config.json -Raw | ConvertFrom-Json $config.version = "2.2" $config.base.tiempo = 60 $config | Add-Member -NotePropertyName "actualizado" -NotePropertyValue "2026-11-18" $config | ConvertTo-Json -Depth 5 | Set-Content -Path config.json Get-Content -Path config.json
salida{
"app": "inventario",
"version": "2.2",
"debug": false,
"puertos": [
8080,
8443
],
"base": {
"servidor": "db.example.com",
"usuario": "lectura",
"tiempo": 60
},
"actualizado": "2026-11-18"
}Para añadir una propiedad nueva a un objeto que vino de JSON se usa Add-Member; asignarla directamente daría error porque no existe. Y siempre -Depth: ConvertTo-Json solo baja dos niveles por omisión y lo demás lo convierte en texto, como se ve en la lección 6.
Datos anidados: pedidos con artículos
$pedidos = Get-Content -Path pedidos.json -Raw | ConvertFrom-Json
foreach ($p in $pedidos) {
$total = ($p.articulos | ForEach-Object { $_.piezas * $_.precio } | Measure-Object -Sum).Sum
"Pedido {0} de {1}: {2} artículo(s), total {3:N2}" -f $p.id, $p.cliente, $p.articulos.Count, $total
}
$pedidos.articulos.sku -join ", "salidaPedido 1001 de Ana: 1 artículo(s), total 1,299.00 Pedido 1002 de Luis: 2 artículo(s), total 1,176.00 TEC-01, MOU-02, CAB-07
La última línea muestra un atajo muy de PowerShell: $pedidos.articulos.sku recorre todos los pedidos, todos sus artículos y saca el sku de cada uno, sin escribir un bucle.
Como hashtable y con validación
$h = Get-Content -Path config.json -Raw | ConvertFrom-Json -AsHashtable
$h.GetType().Name
$h.ContainsKey("debug")
$h["base"]["usuario"]
'{ "app": "x", }' | Test-Json -ErrorAction SilentlyContinue
'{ "app": "x" }' | Test-JsonsalidaOrderedHashtable True lectura False True
Con -AsHashtable (PowerShell 6 o posterior) el resultado es una hashtable ordenada, más rápida y útil cuando las claves son dinámicas. Test-Json comprueba si un texto es JSON válido; la coma sobrante del primero lo invalida. Con -Schema, también comprueba que cumpla un esquema JSON.
Para pedir JSON a una API, Invoke-RestMethod hace la conversión solo: lo que devuelve ya son objetos. Lo vemos en el ejemplo de peticiones HTTP.
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.