Buscar y reemplazar texto en archivos con PowerShell

Cambiar un texto en decenas de archivos, como una dirección de correo, una URL o un nombre de servidor, es tarea de un minuto con PowerShell: Select-String encuentra dónde está y -replace lo cambia. Aquí con una simulación primero y copia de cada archivo, por si acaso.

Imagina un sitio web viejo, en la carpeta sitio, con enlaces http:// que hay que cambiar a https:// en todos los archivos HTML, incluidos los de subcarpetas.

Buscar: en qué archivos y en qué líneas

Get-ChildItem -Path sitio -Recurse -Filter *.html |
    Select-String -Pattern 'http://example\.com' |
    ForEach-Object { "{0}:{1}: {2}" -f (Resolve-Path -Relative $_.Path), $_.LineNumber, $_.Line.Trim() }
salida./sitio/index.html:2: <a href="http://example.com/tienda">Tienda</a>
./sitio/blog/post.html:1: <a href="http://example.com/blog">Blog</a>
./sitio/blog/post.html:2: <a href="http://example.com/tienda">Ver la tienda</a>

Select-String no tiene -Recurse: se le pasan los archivos con Get-ChildItem -Recurse. Cada coincidencia es un objeto con la ruta, el número de línea y la línea. Resolve-Path -Relative acorta la ruta. Para un resumen, solo los nombres de archivo:

Get-ChildItem -Path sitio -Recurse -File |
    Select-String -Pattern 'http://example\.com' -List |
    Select-Object -ExpandProperty Filename
salidaindex.html
notas.txt
post.html

-List se detiene en la primera coincidencia de cada archivo. Aquí aparece también notas.txt, porque esta búsqueda no filtró por extensión.

Reemplazar, con prueba y copia

param([switch]$Aplicar)
$patron = 'http://example\.com'
$nuevo = 'https://example.com'
foreach ($archivo in Get-ChildItem -Path sitio -Recurse -Filter *.html) {
    $texto = Get-Content -LiteralPath $archivo.FullName -Raw
    $cambios = ([regex]::Matches($texto, $patron)).Count
    if ($cambios -eq 0) { continue }
    "{0}: {1} cambio(s)" -f $archivo.Name, $cambios
    if ($Aplicar) {
        Copy-Item -LiteralPath $archivo.FullName -Destination "$($archivo.FullName).bak"
        $texto -replace $patron, $nuevo | Set-Content -LiteralPath $archivo.FullName -NoNewline
    }
}
if (-not $Aplicar) { "Simulación: añade -Aplicar para escribir." }
PS> .\reemplazar.ps1index.html: 1 cambio(s)
post.html: 2 cambio(s)
Simulación: añade -Aplicar para escribir.

Sin -Aplicar, el script solo cuenta. Con él, guarda una copia .bak de cada archivo y lo reescribe:

consolaPS> ./reemplazar.ps1 -Aplicar
index.html: 1 cambio(s)
post.html: 2 cambio(s)
PS> Get-Content sitio/blog/post.html
<a href="https://example.com/blog">Blog</a>
<a href="https://example.com/tienda">Ver la tienda</a>
PS> Get-ChildItem -Path sitio -Recurse -Filter *.bak -Name
index.html.bak
blog/post.html.bak

Los detalles que importan:

  • Get-Content -Raw lee el archivo entero para reemplazar en todo el texto de una vez, y -NoNewline evita que Set-Content añada un salto de línea extra al final.
  • El patrón escapa el punto (example\.com): en una expresión regular, un punto solo es «cualquier carácter».
  • -LiteralPath en lugar de -Path, para que un nombre con corchetes no se tome como comodín.
  • La codificación: PowerShell 7 escribe en UTF-8 sin BOM. Si tus archivos llevaban BOM o estaban en otra codificación, indícala con -Encoding en Set-Content; en Windows PowerShell 5.1 es obligatorio pensarlo, porque escribiría en ANSI.

Reemplazos con grupos

$fechas = "Pagado el 18/11/2026", "Vence el 05/12/2026"
$fechas -replace '(\d{2})/(\d{2})/(\d{4})', '$3-$2-$1'
salidaPagado el 2026-11-18
Vence el 2026-12-05

Los paréntesis capturan partes del texto y $1, $2, $3 las reutilizan. El reemplazo va entre comillas simples: con dobles, PowerShell tomaría $1 por una variable vacía.

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.