Solución de problemas

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/03-troubleshooting/index.md.

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:

Get-PackageUpdateInfo -Verbose

Valida configuraciones y reglas:

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:

Get-PackageUpdateInfo -Force

O reduce el intervalo:

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:

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:

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:

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:

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:

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:

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:

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:

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