PowerShellScript

Tres hábitos de PowerShell que ahorran problemas al administrador de sistemas

Manejo explícito de errores, validación antes de actuar y salidas auditables para scripts que otras personas deberán mantener.

Ilustración de PowerShell
SCRIPT DETAILS
LenguajePowerShell
LicenciaMIT
Historial de versiones (2)
v2 · Tres hábitos de PowerShell que ahorran problemas al administrador de sistemas · 2026-10-25

Automatizar no significa omitir controles

Un buen script comunica qué va a leer o cambiar, valida parámetros y deja una salida útil. Estos tres hábitos hacen más fácil revisar una tarea antes de ejecutarla en un entorno real.

1. Trata errores como errores

$ErrorActionPreference = 'Stop' convierte varios errores no terminantes en errores que puedes capturar. Usa try/catch/finally para registrar el fallo sin ocultarlo ni imprimir secretos.

2. Valida antes de actuar

Comprueba archivos, nombres, permisos y parámetros antes de modificar recursos. Para operaciones con impacto, añade SupportsShouldProcess y usa -WhatIf durante la revisión. Nunca construyas una ruta a partir de una entrada no validada.

3. Produce resultados verificables

Usa objetos estructurados antes de Export-Csv; incluye hora, estado y un identificador no sensible. Separa la salida de diagnóstico de la salida que consume otro script.

El archivo adjunto Get-FileIntegrityReport.ps1 aplica el último hábito: calcula SHA-256 por archivo y guarda un informe, sin modificar los archivos de origen. Prueba primero con una carpeta de prueba y revisa que el CSV no exponga rutas privadas.

Checklist de publicación

  • Parámetros documentados y límites de entrada.
  • Manejo de errores visible.
  • Sin contraseñas, tokens ni datos de tenant.
  • Modo de simulación si la operación cambia estado.
  • Compatibilidad y pruebas declaradas honestamente.

No he ejecutado el archivo en Windows PowerShell o PowerShell 7 en este entorno; revisa el comportamiento antes de usarlo en una tarea real.

v1 · Tres hábitos de PowerShell que ahorran problemas al administrador de sistemas · 2026-10-24

Automatizar no significa omitir controles

Un buen script comunica qué va a leer o cambiar, valida parámetros y deja una salida útil. Estos tres hábitos hacen más fácil revisar una tarea antes de ejecutarla en un entorno real.

1. Trata errores como errores

$ErrorActionPreference = 'Stop' convierte varios errores no terminantes en errores que puedes capturar. Usa try/catch/finally para registrar el fallo sin ocultarlo ni imprimir secretos.

2. Valida antes de actuar

Comprueba archivos, nombres, permisos y parámetros antes de modificar recursos. Para operaciones con impacto, añade SupportsShouldProcess y usa -WhatIf durante la revisión. Nunca construyas una ruta a partir de una entrada no validada.

3. Produce resultados verificables

Usa objetos estructurados antes de Export-Csv; incluye hora, estado y un identificador no sensible. Separa la salida de diagnóstico de la salida que consume otro script.

El archivo adjunto Get-FileIntegrityReport.ps1 aplica el último hábito: calcula SHA-256 por archivo y guarda un informe, sin modificar los archivos de origen. Prueba primero con una carpeta de prueba y revisa que el CSV no exponga rutas privadas.

Checklist de publicación

  • Parámetros documentados y límites de entrada.
  • Manejo de errores visible.
  • Sin contraseñas, tokens ni datos de tenant.
  • Modo de simulación si la operación cambia estado.
  • Compatibilidad y pruebas declaradas honestamente.

No he ejecutado el archivo en Windows PowerShell o PowerShell 7 en este entorno; revisa el comportamiento antes de usarlo en una tarea real.

Automatizar no significa omitir controles

Un buen script comunica qué va a leer o cambiar, valida parámetros y deja una salida útil. Estos tres hábitos hacen más fácil revisar una tarea antes de ejecutarla en un entorno real.

1. Trata errores como errores

$ErrorActionPreference = 'Stop' convierte varios errores no terminantes en errores que puedes capturar. Usa try/catch/finally para registrar el fallo sin ocultarlo ni imprimir secretos.

2. Valida antes de actuar

Comprueba archivos, nombres, permisos y parámetros antes de modificar recursos. Para operaciones con impacto, añade SupportsShouldProcess y usa -WhatIf durante la revisión. Nunca construyas una ruta a partir de una entrada no validada.

3. Produce resultados verificables

Usa objetos estructurados antes de Export-Csv; incluye hora, estado y un identificador no sensible. Separa la salida de diagnóstico de la salida que consume otro script.

El archivo adjunto Get-FileIntegrityReport.ps1 aplica el último hábito: calcula SHA-256 por archivo y guarda un informe, sin modificar los archivos de origen. Prueba primero con una carpeta de prueba y revisa que el CSV no exponga rutas privadas.

Checklist de publicación

  • Parámetros documentados y límites de entrada.
  • Manejo de errores visible.
  • Sin contraseñas, tokens ni datos de tenant.
  • Modo de simulación si la operación cambia estado.
  • Compatibilidad y pruebas declaradas honestamente.
EL

Edward Lopez

IT Consultant y entusiasta del self-hosting. Me gusta entender cómo funcionan las cosas y compartir lo aprendido.

SIGAMOS LA CONVERSACIÓN

Preguntas, ideas y hallazgos.

0

Tu experiencia también cuenta.

Inicia sesión para participar en esta conversación.

Unirme

La conversación empieza contigo.

Busca en títulos, resúmenes y contenido.