Mejores prácticas operativas

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /v1.2.1.0/es/docs/02-operational-best-practices/index.md.

Esta página describe los patrones de operación recomendados para PackageUpdateInfo en herramientas interactivas, perfiles y automatización.

Comienza con el comportamiento predeterminado

Restablece la configuración antes de introducir ajustes personalizados, especialmente en sistemas compartidos:

Set-PackageUpdateSetting -Reset

Inspecciona la configuración y las reglas actuales:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Usa intervalos de actualización para reducir el ruido

Get-PackageUpdateInfo respeta UpdateCheckInterval. Si la última verificación efectiva aún está dentro del intervalo configurado, el cmdlet devuelve temprano.

Establece un intervalo que coincida con tu entorno:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Hours 6)

Usa -Force solo para ejecuciones de verificación ad-hoc:

Get-PackageUpdateInfo -Force

Prefiere un inicio de shell no bloqueante

Un patrón práctico de perfil es:

Start-Job -ScriptBlock {
    Get-PackageUpdateInfo -ShowOnlyNeededUpdate | Export-PackageUpdateInfo
} | Out-Null

Import-PackageUpdateInfo

Por qué esto funciona bien:

• El inicio sigue siendo rápido porque la importación lee datos en caché.
• La verificación en línea costosa se ejecuta en segundo plano.
• Aún obtienes una visibilidad útil de las actualizaciones en cada sesión.

Verifica el alcance explícitamente cuando sea necesario

Usa parámetros de alcance cuando los permisos difieran entre módulos de usuario y del sistema:

Get-PackageUpdateInfo -CurrentUser
Get-PackageUpdateInfo -AllUsers

Usa -Repository en entornos con múltiples repositorios configurados:

Get-PackageUpdateInfo -Repository PSGallery

Diseña reglas cuidadosamente

Usa exclusiones amplias solo cuando sean intencionales. Excluir patrones grandes puede ocultar actualizaciones importantes.

Crea reglas personalizadas enfocadas para módulos con alta rotación:

Add-PackageUpdateRule -IncludeModuleForChecking "Az.*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $false -ReportChangeOnRevision $false

Revisa la precedencia de las reglas listando todas ellas:

Get-PackageUpdateRule -IncludeDefaultRule | Sort-Object Id

Usa exportación/importación de manera intencionada

Las rutas predeterminadas de exportación e importación son específicas de la plataforma e incluyen la edición de PowerShell y la versión principal en el nombre del archivo. Esto ayuda a evitar mezclar datos de diferentes entornos de ejecución.

Opciones comunes de exportación:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat XML
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV

Guía recomendada:

• Usa XML cuando quieras conservar objetos tipados para reimportar.
• Usa JSON o CSV para informes externos e integración.
• Usa -IncludeTimeStamp para seguimiento histórico.

Mantén las notificaciones útiles

Usa notificaciones toast solo donde aporten valor:

• En hosts Windows con BurntToast instalado.
• En sesiones donde se esperan alertas interactivas.

Para servidores, CI y shells no interactivos, prefiere informes exportados en lugar de notificaciones toast.