# Visión general

LLMS index: [llms.txt](/llms.txt)

---

PackageUpdateInfo te ayuda a mantener actualizados los módulos de PowerShell instalados. Compara las versiones locales de los módulos con las versiones de los repositorios en línea configurados (por ejemplo, PSGallery) y reporta cuando hay versiones más nuevas disponibles.

## ¿Qué hace PackageUpdateInfo?

El módulo puede:

- Consultar los módulos instalados localmente.
- Descubrir las versiones actuales en línea.
- Comparar versiones con sensibilidad configurable (mayor, menor, compilación, revisión).
- Mostrar una salida enriquecida que incluye enlace al repositorio, notas de lanzamiento, autor y enlaces al proyecto.
- Exportar resultados para importarlos más tarde y facilitar flujos de trabajo de inicio rápido.

## ¿Por qué usar PackageUpdateInfo?

### Conveniencia

- Identifica rápidamente módulos desactualizados sin tener que revisar manualmente cada uno.
- Exporta e importa información de actualizaciones para revisión offline o diferida.
- Ejecuta comprobaciones de actualización en trabajos en segundo plano.
- Usa notificaciones emergentes opcionales en Windows.

### Automatización

- Programa comprobaciones de actualización usando tu perfil, tareas programadas o rutinas de inicio.
- Establece un intervalo de comprobación de actualizaciones para reducir consultas innecesarias a los repositorios.
- Mantén reglas personalizadas por patrón de módulo para la sensibilidad de actualización.
- Reutiliza datos exportados previamente para un inicio de shell de baja latencia.

### Flexibilidad

- Incluye o excluye patrones de nombres de módulos.
- Define el alcance y la precedencia de reglas con reglas predeterminadas y personalizadas.
- Funciona en Windows, Linux y macOS.
- Soporta Windows PowerShell 5.1 y PowerShell 7+.

## Requisitos previos

- Windows PowerShell 5.1 o PowerShell 7+.
- PowerShellGet con acceso a tu repositorio objetivo (por ejemplo, PSGallery).
- Opcional: módulo BurntToast para notificaciones emergentes en Windows.

## Instalación

Instala para todos los usuarios (requiere derechos administrativos):

```powershell
Install-Module PackageUpdateInfo
```

Instala para el usuario actual:

```powershell
Install-Module PackageUpdateInfo -Scope CurrentUser
```

## Inicio rápido

Ejecuta una comprobación interactiva:

```powershell
Get-PackageUpdateInfo
```

Muestra solo los módulos que necesitan una actualización:

```powershell
Get-PackageUpdateInfo -ShowOnlyNeededUpdate
```

Forzar una comprobación incluso si el intervalo de actualización configurado no ha expirado:

```powershell
Get-PackageUpdateInfo -Force
```

Usa notificaciones emergentes (Windows con BurntToast):

```powershell
Get-PackageUpdateInfo -ShowToastNotification
```

## Patrón práctico de automatización

Exporta datos de actualización en un trabajo en segundo plano e impórtalos al iniciar la shell:

```powershell
Start-Job -ScriptBlock { Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification | Export-PackageUpdateInfo } | Out-Null
Import-PackageUpdateInfo
```

Esto mantiene la interacción en el inicio mientras muestra información reciente de actualizaciones.

## Próximos pasos

- Continúa con las mejores prácticas operativas para ajuste, diseño de reglas y automatización.
- Continúa con la resolución de problemas para errores comunes y flujos de recuperación.