# Solución de problemas

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

---

Utiliza esta guía cuando PackageUpdateInfo no devuelva resultados esperados, omita
verificaciones o falle al importar y exportar datos.

## Obtén diagnósticos útiles primero

Ejecuta con salida detallada:

```powershell
Get-PackageUpdateInfo -Verbose
```

Valida configuraciones y reglas:

```powershell
Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule
```

## Verificación omitida inesperadamente

Síntoma:

- Ves una advertencia de que las verificaciones de actualización se omiten porque
  el intervalo de comprobación no ha expirado.

Causa:

- `UpdateCheckInterval` y `LastCheck` o `LastSuccessfulCheck` recientes
  impiden una nueva comprobación en línea.

Resolución:

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

O reduce el intervalo:

```powershell
Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Minutes 30)
```

## El archivo de configuración falta o está dañado

Síntoma:

- `Get-PackageUpdateSetting` advierte que no se encontró el archivo de configuración del módulo, y luego lanza una excepción.

Causa:

- La ruta del archivo de configuración no existe o contiene JSON inválido.

Resolución:

```powershell
Set-PackageUpdateSetting -Reset
Get-PackageUpdateSetting
```

## No se devuelven módulos

Síntoma:

- `Get-PackageUpdateInfo` no devuelve nada aunque hay módulos instalados.

Causas comunes:

- Las reglas de inclusión y exclusión filtran todos los módulos.
- `-CurrentUser` o `-AllUsers` filtran los módulos que esperas.
- El filtrado por repositorio excluye los módulos relevantes.

Pasos de resolución:

```powershell
Get-PackageUpdateRule -IncludeDefaultRule
Get-PackageUpdateInfo -Force
Get-PackageUpdateInfo -CurrentUser -Force
Get-PackageUpdateInfo -AllUsers -Force
```

## La exportación falla por errores en la ruta

Síntoma:

- La exportación reporta problemas con rutas o directorios inválidos.

Causa:

- `-Path` apunta a un directorio o a una ubicación que no existe sin `-Force`.

Resolución:

```powershell
Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.xml" -Force
```

## La importación no devuelve datos

Síntoma:

- `Import-PackageUpdateInfo` no devuelve nada.

Causas comunes:

- El archivo está vacío o es demasiado pequeño para contener registros.
- `-InputFormat` no coincide con el formato exportado.
- Ruta de archivo incorrecta para la versión y edición en uso.

Resolución:

```powershell
Import-PackageUpdateInfo -InputFormat XML -Verbose
Import-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.json" -InputFormat JSON
```

## Las notificaciones toast no aparecen

Síntoma:

- Se usa `-ShowToastNotification`, pero no aparece ninguna notificación.

Causas comunes:

- BurntToast no está instalado.
- La plataforma host no soporta notificaciones toast de Windows.
- Ningún módulo en el resultado tiene `NeedUpdate = $true`.

Resolución:

```powershell
Install-Module BurntToast -Scope CurrentUser
Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification -Force
```

## No se pueden agregar o modificar reglas

Síntoma:

- La adición de una regla falla con Id duplicado, valores de include o exclude.

Causa:

- Las reglas personalizadas existentes ya contienen los mismos identificadores o patrones.

Resolución:

```powershell
Get-PackageUpdateRule
Add-PackageUpdateRule -IncludeModuleForChecking "MyModule.*"
Set-PackageUpdateRule -Id 1 -ReportChangeOnRevision $false
Remove-PackageUpdateRule -Id 1
```

## Problemas con repositorios y red

Síntoma:

- La búsqueda en línea de versiones falla o está incompleta.

Causas comunes:

- El repositorio no está registrado o no se puede acceder.
- Problemas temporales de red.

Resolución:

```powershell
Get-PSRepository
Find-Module PackageUpdateInfo -Repository PSGallery
Get-PackageUpdateInfo -Repository PSGallery -Force
```

## Flujo de recuperación

Si el comportamiento sigue siendo inconsistente, usa esta secuencia de restablecimiento:

```powershell
Set-PackageUpdateSetting -Reset
Get-PackageUpdateInfo -Force | Export-PackageUpdateInfo
Import-PackageUpdateInfo
```