Versión imprimible multipagina. Haga click aquí para imprimir.

Volver a la vista normal de esta página.

Acerca de esta documentación

1: Visión general
2: Mejores prácticas operativas
3: Solución de problemas
4: Referencia de comandos del módulo

4.1: Add-PackageUpdateRule
4.2: Export-PackageUpdateInfo
4.3: Get-PackageUpdateInfo
4.4: Get-PackageUpdateRule
4.5: Get-PackageUpdateSetting
4.6: Import-PackageUpdateInfo
4.7: Remove-PackageUpdateRule
4.8: Set-PackageUpdateRule
4.9: Set-PackageUpdateSetting
4.10: Show-PackageUpdateReleaseNote

Esta es la página oficial de documentación para PackageUpdateInfo, un módulo de PowerShell que te ayuda a mantenerte al día con tus módulos instalados verificando todos los módulos de PowerShell instalados localmente y reportando cuáles necesitan una actualización.

Acerca del módulo

PackageUpdateInfo nació de una necesidad del mundo real: hacer un seguimiento de las actualizaciones de módulos en muchos módulos de PowerShell instalados puede ser tedioso y fácil de olvidar. Este módulo cierra esa brecha al verificar automáticamente todos los módulos instalados contra la Galería de PowerShell y presentar una visión clara de las actualizaciones disponibles.

Principios clave de diseño:

Multiplataforma — soporta Windows, Linux y macOS
Compatibilidad entre ediciones — soporta PowerShell Desktop (5.1+) y Core (7.x)
Configurabilidad — personaliza los intervalos de verificación de actualizaciones, reglas de sensibilidad de versiones y exclusiones
Compatible con pipeline — se integra de manera natural con la arquitectura de pipeline de PowerShell
Soporte de notificaciones — notificaciones de escritorio BurntToast opcionales en Windows

Recursos

GitHub: https://github.com/AndiBellstedt/PackageUpdateInfo
Galería de PowerShell: https://www.powershellgallery.com/packages/PackageUpdateInfo
Blog del autor: https://andibellstedt.com

Contribuciones

Las contribuciones son bienvenidas. Si encuentras problemas, errores o tienes sugerencias de mejoras, por favor abre un issue o pull request en el repositorio de GitHub.

1 - Visión general

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):

Install-Module PackageUpdateInfo

Instala para el usuario actual:

Install-Module PackageUpdateInfo -Scope CurrentUser

Inicio rápido

Ejecuta una comprobación interactiva:

Get-PackageUpdateInfo

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

Get-PackageUpdateInfo -ShowOnlyNeededUpdate

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

Get-PackageUpdateInfo -Force

Usa notificaciones emergentes (Windows con BurntToast):

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:

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.

2 - Mejores prácticas operativas

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.

3 - Solución de problemas

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

4 - Referencia de comandos del módulo

Aquí, puedes encontrar una referencia para todos los comandos del módulo. Esta referencia está diseñada para ayudarte a encontrar rápidamente el comando que necesitas y entender cómo usarlo de manera efectiva.

Al hacer clic en un comando, serás llevado a una página detallada que proporciona información completa sobre el comando, incluyendo su sintaxis, parámetros, ejemplos y cualquier nota o consejo adicional para su uso.

4.1 - Add-PackageUpdateRule

SYNOPSIS

Agrega una regla personalizada que controla cómo se reportan las actualizaciones de módulos.

SYNTAX

__AllParameterSets

Add-PackageUpdateRule [[-Id] <int>] [[-IncludeModuleForChecking] <string[]>]
 [[-ExcludeModuleFromChecking] <string[]>] [[-ReportChangeOnMajor] <bool>]
 [[-ReportChangeOnMinor] <bool>] [[-ReportChangeOnBuild] <bool>] [[-ReportChangeOnRevision] <bool>]
 [[-SettingObject] <Configuration>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Este cmdlet tiene los siguientes alias,

DESCRIPTION

Este comando crea una regla de actualización personalizada para la configuración actual de PackageUpdateInfo. Cada regla define cuándo una actualización debe considerarse relevante para reportar, basada en cambios en la parte mayor, menor, de compilación o revisión de la versión de un módulo. Las reglas también pueden limitar el reporte a módulos específicos incluyendo o excluyendo nombres de módulos, lo que permite suprimir actualizaciones ruidosas solo de revisión o enfocar las comprobaciones en módulos seleccionados. Si no se proporciona un objeto de configuración, el comando usa la configuración actual del módulo y almacena la nueva regla allí.

EXAMPLES

EXAMPLE 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Agrega una regla que reporta actualizaciones mayores, menores y de compilación para MyModule mientras suprime cambios solo de revisión.

EXAMPLE 2

PS C:\> Add-PackageUpdateRule -ExcludeModuleFromChecking "PowerShellGet","PSScriptAnalyzer" -ReportChangeOnRevision $false

Agrega una regla que excluye dos módulos de la comprobación de actualizaciones y suprime actualizaciones de revisión para los módulos restantes.

EXAMPLE 3

PS C:\> Add-PackageUpdateRule -Id 99 -IncludeModuleForChecking "MyModule" -PassThru

Agrega una regla con un identificador específico y devuelve el objeto de regla creado.

EXAMPLE 4

PS C:\> $settings = Get-PackageUpdateSetting; Add-PackageUpdateRule -SettingObject $settings -ExcludeModuleFromChecking "MyModule"

Agrega una regla a un objeto de configuración existente sin usar la configuración predeterminada del módulo.

PARAMETERS

-Confirm

Solicita confirmación antes de guardar la nueva regla.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Uno o más nombres de módulos que deben ser excluidos de la comprobación de actualizaciones por esta regla.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

El identificador único para la regla.

Type: Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Uno o más nombres de módulos que deben incluirse en la comprobación de actualizaciones por esta regla. Si se omite, la regla se aplica a todos los módulos.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Devuelve el objeto de regla creado desde la canalización.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Indica si un cambio en la parte de la versión de compilación debería activar un reporte de actualización.

Esto significa que ‘Get-PackageUpdateSetting’ reportará una actualización solo cuando cambie la versión de compilación de un módulo. Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 5
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Indica si un cambio en la parte mayor de la versión debería activar un reporte de actualización.

Esto significa que ‘Get-PackageUpdateSetting’ reportará una actualización solo cuando cambie la versión mayor de un módulo.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Indica si un cambio en la parte menor de la versión debería activar un reporte de actualización.

Esto significa que ‘Get-PackageUpdateSetting’ reportará una actualización solo cuando cambie la versión menor de un módulo.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 4
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Indica si un cambio en la parte de revisión de la versión debería activar un reporte de actualización.

Esto significa que ‘Get-PackageUpdateSetting’ reportará la necesidad de actualización cuando cambie la versión de revisión de un módulo.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: True
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 6
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Un objeto de configuración obtenido con Get-PackageUpdateSetting que debe recibir la nueva regla. Si se omite, se usan las configuraciones actuales del módulo.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 7
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Muestra qué pasaría si se ejecutara el comando sin cambiar ninguna configuración.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Este cmdlet soporta los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulta about_CommonParameters.

INPUTS

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

NOTES

Version : 1.1.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module, Rule

packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule

4.2 - Export-PackageUpdateInfo

SINOPSIS

Exporta objetos PackageUpdateInfo a un archivo XML, JSON o CSV.

SINTAXIS

__AllParameterSets

Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
 [-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Escribe objetos PackageUpdateInfo producidos por Get-PackageUpdateInfo en un archivo de datos estructurado para persistencia, informes o automatización posterior. El cmdlet soporta formatos de salida XML, JSON y CSV, con opción de incluir marca de tiempo y modo de anexar para extender un archivo existente. También soporta la creación del directorio destino cuando es necesario y puede pasar los objetos exportados de nuevo a través de la canalización.

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo

Exporta los objetos PackageUpdateInfo actuales al archivo XML predeterminado.

EJEMPLO 2

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON -Path .\updates.json -IncludeTimeStamp -PassThru

Exporta los datos como JSON, incluye una marca de tiempo para cada registro y pasa los objetos a través de la canalización.

EJEMPLO 3

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV -Path .\updates.csv -Append -Force

Anexa los datos exportados a un archivo CSV y crea el directorio destino si no existe.

EJEMPLO 4

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path C:\Temp\PackageUpdateInfo.xml -Encoding utf8

Exporta los datos actuales a un archivo XML personalizado usando codificación UTF-8.

PARÁMETROS

-Append

Agrega la información exportada a un archivo existente en lugar de reemplazar su contenido actual. Esto es compatible para salida JSON y CSV y se ignora para salida XML.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Confirm

Si este interruptor está habilitado, se te pedirá confirmación antes de ejecutar cualquier operación que cambie el estado.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Encoding

La codificación del archivo a usar al crear o actualizar el archivo de exportación.

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Crea el directorio padre para el archivo destino cuando no existe y la ruta especificada está fuera de la ubicación predeterminada.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeTimeStamp

Agrega una propiedad TimeStamp a cada registro exportado para que la exportación capture la hora de exportación de cada entrada.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Uno o más objetos PackageUpdateInfo para exportar. Este parámetro acepta entrada por canalización desde Get-PackageUpdateInfo y comandos similares.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OutputFormat

El formato de salida usado para la exportación. Los valores soportados son “XML”, “JSON” y “CSV”.

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Envía los objetos exportados a la canalización después de escribirlos en disco.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

La ruta del archivo destino para los datos exportados. Especifica una ruta de archivo en lugar de una ruta de directorio.

El valor predeterminado de la ruta es: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si este interruptor está habilitado, no se realizan acciones, pero se muestran mensajes informativos que explican qué pasaría si se ejecutara el comando.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Este cmdlet soporta los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, y -WarningVariable. Para más información, consulta about_CommonParameters.

ENTRADAS

PackageUpdate.Info[]

SALIDAS

PackageUpdate.Info

NOTAS

Versión : 1.1.0.0
Autor : Andi Bellstedt
Fecha : 2026-06-21
Palabras clave : PackageUpdateInfo, Update, Module, Export

ENLACES RELACIONADOS

packageupdateinfo.andibellstedt.com/docs/commands/export-packageupdateinfo

4.3 - Get-PackageUpdateInfo

SINOPSIS

Recupera información de actualización para los módulos de PowerShell instalados e identifica los módulos que tienen versiones más recientes disponibles en línea.

SINTAXIS

DefaultSet1 (Predeterminado)

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-Force] [<CommonParameters>]

CurrentUser

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]

AllUsers

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Get-PackageUpdateInfo inspecciona los módulos de PowerShell instalados localmente, compara sus versiones instaladas con las versiones disponibles en uno o más repositorios configurados, y devuelve información detallada sobre actualizaciones.

El comando puede filtrar los resultados para mostrar solo los módulos que necesitan actualizaciones, restringir la búsqueda a las rutas de módulos del usuario actual o de todos los usuarios, y opcionalmente mostrar notificaciones tipo toast de Windows cuando hay actualizaciones disponibles.

También respeta las reglas de verificación de actualización del módulo y el intervalo configurado para dicha verificación, a menos que fuerces explícitamente una comprobación nueva.

La comprobación se realiza mediante PowerShellGet v2 o v3, dependiendo de la disponibilidad del módulo Microsoft.PowerShell.PSResourceGet en el sistema.

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateInfo

Recupera información de actualización para todos los módulos que se descubren a partir de las reglas de inclusión configuradas y los repositorios disponibles. La salida muestra la versión instalada, la última versión en línea y si se necesita una actualización. La salida puede verse así:

Name Repository VersionInstalled VersionOnline NeedUpdate Path

PSReadline PSGallery 1.2 1.2 False C:\Program Files\WindowsPowerShell\Modules\PSReadline Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

EJEMPLO 2

PS C:\> Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Devuelve solo aquellos módulos donde hay una versión más reciente disponible en línea, facilitando enfocarse en los módulos que realmente necesitan atención. Esto filtrará la salida para mostrar solo los módulos donde NeedUpdate es True. La salida puede verse así:

Name Repository VersionInstalled VersionOnline NeedUpdate Path

Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

EJEMPLO 3

PS C:\> "Pester", "PSReadline" | Get-PackageUpdateInfo

Acepta nombres de módulos desde la canalización y devuelve información de actualización para cada módulo solicitado. Esto también funciona con objetos que exponen una propiedad Name, como los módulos devueltos por Get-Module.

EJEMPLO 4

PS C:\> Get-PackageUpdateInfo -CurrentUser -ShowOnlyNeededUpdate

Verifica solo los módulos instalados en el perfil del usuario actual y muestra únicamente aquellos módulos que tienen una versión más reciente disponible en línea.

PARÁMETROS

-AllUsers

Restringe la búsqueda a los módulos instalados en ubicaciones compartidas para todos los usuarios o en módulos del sistema.

Ten en cuenta que se requieren derechos de administrador para actualizar esos módulos.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: AllUsers
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-CurrentUser

Restringe la búsqueda a los módulos instalados en la ubicación del perfil del usuario actual.

Esto es útil si estás ejecutando sin derechos de administrador, lo cual siempre deberías hacer como preferencia predeterminada.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: CurrentUser
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Ignora el intervalo configurado para la verificación de actualizaciones y realiza una comparación nueva de inmediato.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Name

Uno o más nombres de módulos para inspeccionar. Cuando se omite este parámetro, la función usa las reglas de inclusión configuradas para determinar qué módulos deben verificarse.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Repository

Uno o más repositorios de PowerShell para consultar las versiones disponibles de los módulos. Si se omite, el comando usa los repositorios disponibles en el sistema local.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowOnlyNeededUpdate

Suprime los módulos que ya están actualizados en la salida y devuelve solo los módulos donde hay una actualización disponible.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Muestra notificaciones tipo toast de Windows para los módulos que tienen actualizaciones disponibles cuando el sistema soporta esta función.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Este cmdlet soporta los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, y -WarningVariable. Para más información, consulta about_CommonParameters.

ENTRADAS

System.String[]

SALIDAS

PackageUpdate.Info

NOTAS

Versión : 1.2.0.0 Autor : Andi Bellstedt Fecha : 2026-06-21 Palabras clave : PackageUpdateInfo, Update, Module

ENLACES RELACIONADOS

packageupdateinfo.andibellstedt.com/docs/commands/get-packageupdateinfo

4.4 - Get-PackageUpdateRule

SINOPSIS

Recupera una o más reglas de actualización de paquetes utilizadas para controlar las comprobaciones y reportes de actualización de módulos.

SINTAXIS

ShowAll (Predeterminado)

Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
 [-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]

ById

Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Recupera las reglas personalizadas que definen cómo se manejan los módulos durante las comprobaciones y reportes de actualización. Puedes filtrar las reglas por identificador, por patrones de inclusión o exclusión de módulos, o incluir la regla predeterminada del objeto de configuración activo para comparar el comportamiento personalizado con el comportamiento de respaldo incorporado.

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateRule

Recupera todas las reglas personalizadas configuradas actualmente para el manejo de actualización de paquetes.

EJEMPLO 2

PS C:\> Get-PackageUpdateRule -Id 1, 2

Recupera las reglas personalizadas que tienen los identificadores especificados.

EJEMPLO 3

PS C:\> Get-PackageUpdateRule -ExcludeModuleFromChecking 'Pester'

Recupera las reglas personalizadas que excluyen a Pester de la comprobación de actualizaciones.

EJEMPLO 4

PS C:\> Get-PackageUpdateRule -IncludeModuleForChecking 'PackageManagement' -IncludeDefaultRule

Recupera las reglas personalizadas que incluyen PackageManagement para la comprobación de actualizaciones y también devuelve la regla predeterminada.

PARÁMETROS

-ExcludeModuleFromChecking

Filtra las reglas devueltas para aquellas que excluyen el nombre del módulo especificado de la comprobación de actualizaciones.

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

Especifica uno o más identificadores de regla para recuperar.

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeDefaultRule

Agrega la regla predeterminada del objeto de configuración suministrado o activo a la salida, además de cualquier regla personalizada.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Filtra las reglas devueltas para aquellas que incluyen el nombre del módulo especificado para la comprobación de actualizaciones. Por defecto, todos los módulos están incluidos cuando no se suministra ningún filtro.

El valor predeterminado es: “*”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Especifica un objeto de configuración devuelto por Get-PackageUpdateSetting. Si se omite este parámetro, el comando usa el objeto de configuración de módulo actual.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulta about_CommonParameters.

ENTRADAS

System.Int32[]

PackageUpdate.Configuration

SALIDAS

PackageUpdate.ModuleRule

NOTAS

Versión : 1.1.0.0
Autor : Andi Bellstedt
Fecha : 2026-06-21
Palabras clave : PackageUpdateInfo, Update, Module, Rule

ENLACES RELACIONADOS

packageupdateinfo.andibellstedt.com/docs/commands/get-packageupdaterule

4.5 - Get-PackageUpdateSetting

SINOPSIS

Recupera la configuración de PackageUpdateInfo desde el archivo de configuración del módulo.

SINTAXIS

__AllParameterSets

Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Lee el archivo de configuración de PackageUpdateInfo y devuelve la configuración actual del comportamiento del módulo como un objeto PackageUpdate.Configuration. El objeto devuelto incluye las reglas de actualización predeterminadas y personalizadas, el intervalo de comprobación de actualizaciones y las marcas de tiempo de la última comprobación y de la última comprobación exitosa.

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateSetting

Recupera la configuración actual de PackageUpdateInfo desde el archivo de configuración predeterminado.

EJEMPLO 2

PS C:\> Get-PackageUpdateSetting -Path "C:\temp\PackageUpdateInfo.json"

Lee la configuración de PackageUpdateInfo desde un archivo de configuración específico.

EJEMPLO 3

PS C:\> Get-PackageUpdateSetting | Select-Object -ExpandProperty UpdateCheckInterval

Devuelve el intervalo configurado para la comprobación de actualizaciones desde la configuración actual.

PARÁMETROS

-Path

La ruta completa al archivo de configuración que se desea leer.

Este parámetro es opcional. Si se omite, la función usa la ruta de configuración predeterminada del módulo: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).json” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”

Type: String
DefaultValue: $script:ModuleSettingPath
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

SALIDAS

PackageUpdate.Configuration

NOTAS

Versión : 1.1.0.0 Autor : Andi Bellstedt Fecha : 2026-06-21 Palabras clave : PackageUpdateInfo, Update, Module, Setting

ENLACES RELACIONADOS

packageupdateinfo.andibellstedt.com/docs/commands/get-packageupdatesetting

4.6 - Import-PackageUpdateInfo

SINOPSIS

Importa información de actualización de paquetes desde un archivo de datos exportado previamente.

SINTAXIS

__AllParameterSets

Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
 [-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Importa información de actualización de paquetes desde un archivo de datos que fue exportado previamente por Export-PackageUpdateInfo. El comando lee registros desde archivos XML, JSON o CSV y los convierte en objetos PackageUpdateInfo para su uso, visualización o procesamiento posterior. Cuando se solicita, también puede mostrar notificaciones tipo toast de Windows para los módulos que requieren una actualización.

EJEMPLOS

EJEMPLO 1

PS C:\> Import-PackageUpdateInfo

Importa el archivo de información de actualización de paquetes predeterminado para el entorno actual de PowerShell.

EJEMPLO 2

PS C:\> Import-PackageUpdateInfo -Path C:\temp\packageupdateinfo.xml

Importa información de actualización desde un archivo XML específico.

EJEMPLO 3

PS C:\> Import-PackageUpdateInfo -Path .\updates.json -InputFormat JSON

Importa información de actualización desde un archivo JSON que usa el formato de entrada especificado.

EJEMPLO 4

PS C:\> Import-PackageUpdateInfo -Path .\updates.csv -InputFormat CSV -ShowToastNotification

Importa información de actualización desde un archivo CSV y muestra notificaciones tipo toast para los módulos que necesitan actualizaciones.

PARÁMETROS

-Confirm

Si este interruptor está habilitado, se te pedirá confirmación antes de ejecutar cualquier operación que cambie el estado.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Encoding

Especifica la codificación del archivo que se usa al leer el archivo de entrada.

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputFormat

Especifica el formato del archivo de datos importado. Los valores compatibles son “XML”, “JSON” y “CSV”.

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

La ruta del archivo de datos a importar. Especifica una ruta de archivo válida. Si se omite, el comando usa el archivo de datos del módulo predeterminado para la edición y versión actual de PowerShell.

Las rutas predeterminadas son: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Muestra notificaciones tipo toast de Windows con información de notas de la versión para los módulos que requieren una actualización.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si este interruptor está habilitado, no se realizan acciones, pero se mostrarán mensajes informativos que explican qué pasaría si se ejecutara el comando.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

ENTRADAS

System.String

SALIDAS

PackageUpdate.Info

NOTAS

Versión : 1.1.0.0
Autor : Andi Bellstedt
Fecha : 2026-06-21
Palabras clave : PackageUpdateInfo, Update, Module, Info

ENLACES RELACIONADOS

packageupdateinfo.andibellstedt.com/docs/commands/import-packageupdateinfo

4.7 - Remove-PackageUpdateRule

SYNOPSIS

Elimina una o más reglas personalizadas para el manejo de actualizaciones de la configuración de actualización de paquetes.

SYNTAX

ById (Predeterminado)

Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

ByInputObject

Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
 [-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIASES

Este cmdlet tiene los siguientes alias,

DESCRIPTION

Elimina reglas personalizadas existentes que definen cómo deben manejarse módulos específicos de PowerShell durante las comprobaciones y reportes de actualización. El comando puede eliminar reglas por Id de regla, pasando objetos de regla desde Get-PackageUpdateRule, o actualizando un objeto de configuración que contiene la colección de reglas.

Cuando se eliminan reglas, la configuración actualizada se escribe nuevamente en el archivo de configuración para que el cambio persista. Usa -PassThru para devolver los objetos de regla eliminados al pipeline.

EXAMPLES

EJEMPLO 1

PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule

Elimina todas las reglas personalizadas de actualización de la configuración actual del módulo.

EJEMPLO 2

PS C:\> Remove-PackageUpdateRule -Id 12

Elimina la regla personalizada con Id 12 de la configuración actual.

EJEMPLO 3

$rules = Get-PackageUpdateRule -Name "Microsoft.PowerShell.Utility"
PS C:\> $rules | Remove-PackageUpdateRule -PassThru

Elimina las reglas coincidentes y devuelve los objetos de regla eliminados al pipeline.

EJEMPLO 4

$settings = Get-PackageUpdateSetting
PS C:\> Remove-PackageUpdateRule -Id 3 -SettingObject $settings -Force

Elimina una regla específica sin pedir confirmación y escribe la configuración actualizada en disco.

PARAMETERS

-Confirm

Si este interruptor está activado, se te pedirá confirmación antes de ejecutar cualquier operación que cambie el estado.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Suprime la solicitud de confirmación y elimina la regla inmediatamente.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

El Id de la regla a eliminar. Acepta uno o más identificadores de regla.

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Uno o más objetos de regla a eliminar. Normalmente son devueltos por Get-PackageUpdateRule.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Devuelve el/los objeto(s) de regla eliminados al pipeline para procesamiento adicional.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

El objeto de configuración que contiene la colección de reglas. Si no se suministra este parámetro, el comando usa la configuración actual del módulo obtenida con Get-PackageUpdateSetting.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si este interruptor está activado, no se realizan acciones pero se mostrarán mensajes informativos que explican qué sucedería si se ejecutara el comando.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Este cmdlet soporta los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, y -WarningVariable. Para más información, consulta about_CommonParameters.

INPUTS

System.Int32[]

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

NOTES

Versión : 1.1.0.0 Autor : Andi Bellstedt Fecha : 2026-06-21 Palabras clave : PackageUpdateInfo, Update, Module, Rule

packageupdateinfo.andibellstedt.com/docs/commands/remove-packageupdaterule

4.8 - Set-PackageUpdateRule

SINOPSIS

Actualiza una regla existente de PackageUpdateInfo que controla cómo se reportan los cambios de versión de un módulo.

SINTAXIS

PorId (Predeterminado)

Set-PackageUpdateRule -Id <int> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

PorObjetoDeEntrada

Set-PackageUpdateRule -InputObject <ModuleRule[]> [-IncludeModuleForChecking <string[]>]
 [-ExcludeModuleFromChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-SettingObject <Configuration>]
 [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Este cmdlet modifica una regla de actualización existente almacenada en la configuración de PackageUpdateInfo para que las comprobaciones de actualización puedan restringirse o ampliarse para módulos específicos.
Puedes usarlo para incluir o excluir módulos de la detección de actualizaciones, controlar qué partes de la versión activan un informe de actualización y guardar esos cambios de regla en el archivo de configuración activo.
El comando funciona con una regla identificada por Id o con un objeto de regla suministrado mediante InputObject, y puede devolver la regla actualizada cuando se especifica -PassThru.

EJEMPLOS

EJEMPLO 1

PS C:\> Set-PackageUpdateRule -Id 3 -IncludeModuleForChecking 'MyModule' -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false -PassThru

Actualiza la regla 3 para que MyModule se evalúe explícitamente y solo se reporten como necesarias las actualizaciones por cambios mayores, menores y de compilación.

EJEMPLO 2

PS C:\> Get-PackageUpdateRule -Id 7 | Set-PackageUpdateRule -ExcludeModuleFromChecking 'AzureTools' -ReportChangeOnRevision $false

Toma la regla con Id 7 desde la canalización y suprime el reporte de actualizaciones basadas en revisiones para AzureTools, manteniendo la regla almacenada en la configuración actual.

EJEMPLO 3

$rule = Get-PackageUpdateRule -Id 12
PS C:\> Set-PackageUpdateRule -InputObject $rule -IncludeModuleForChecking 'PowershellGet','PSReadLine' -ReportChangeOnMinor $false -ReportChangeOnBuild $false

Carga un objeto de regla existente, amplía los módulos incluidos y actualiza la regla para que solo los cambios mayores y de revisión se consideren actualizaciones accionables.

EJEMPLO 4

PS C:\> Set-PackageUpdateRule -Id 5 -ReportChangeOnMajor $false -ReportChangeOnMinor $false -ReportChangeOnBuild $false -ReportChangeOnRevision $true -WhatIf

Muestra el efecto de cambiar la regla 5 para reportar solo actualizaciones basadas en revisiones sin escribir realmente el cambio en disco.

PARÁMETROS

-Confirm

Solicita confirmación antes de que el cmdlet escriba los datos de la regla modificada en el archivo de configuración.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Uno o más nombres de módulos que deben excluirse de las comprobaciones de actualización para la regla que se está modificando.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

El identificador numérico de la regla a modificar.

Type: Int32
DefaultValue: 0
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Uno o más nombres de módulos que deben incluirse en las comprobaciones de actualización para la regla que se está modificando.
Cuando se omite, la regla mantiene el comportamiento predeterminado de evaluar todos los módulos.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

El objeto de regla a actualizar.
Esto es útil cuando ya tienes una regla de Get-PackageUpdateRule y quieres cambiarla sin referirte a su Id.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Devuelve el objeto de regla actualizado a la canalización después de que el cambio se haya escrito en el archivo de configuración.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Controla si un cambio en la parte de la versión de compilación hace que la regla reporte que se necesita una actualización.

Reportar cuando cambia la versión de compilación de un módulo

Esto significa que ‘Get-PackageUpdateSetting’ reporta necesidad de actualización,
solo cuando cambia la versión de compilación de un módulo.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Controla si un cambio en la parte mayor de la versión hace que la regla reporte que se necesita una actualización.

Reportar cuando cambia la versión mayor de un módulo

Esto significa que ‘Get-PackageUpdateSetting’ reporta necesidad de actualización,
solo cuando cambia la versión mayor de un módulo.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Controla si un cambio en la parte menor de la versión hace que la regla reporte que se necesita una actualización.

Reportar cuando cambia la versión menor de un módulo

Esto significa que ‘Get-PackageUpdateSetting’ reporta necesidad de actualización,
solo cuando cambia la versión menor de un módulo.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Controla si un cambio en la parte de revisión de la versión hace que la regla reporte que se necesita una actualización.

Reportar cuando cambia la parte de revisión de un módulo

Esto significa que ‘Get-PackageUpdateSetting’ reporta necesidad de actualización,
solo cuando cambia la versión de revisión de un módulo.

Major Minor Build Revision

0 0 0 1

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

El objeto de configuración PackageUpdateInfo a actualizar.
Cuando se omite, el cmdlet usa la configuración actual del módulo de Get-PackageUpdateSetting.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Muestra qué pasaría si se ejecutara el comando sin aplicar ningún cambio.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulta
about_CommonParameters.

ENTRADAS

System.Int32

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

SALIDAS

PackageUpdate.ModuleRule

NOTAS

Versión : 1.1.0.0
Autor : Andi Bellstedt
Fecha : 2026-06-21
Palabras clave : PackageUpdateInfo, Update, Module, Rule

ENLACES RELACIONADOS

packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdaterule

4.9 - Set-PackageUpdateSetting

SINOPSIS

Configura el comportamiento de comprobación de actualizaciones y las preferencias de reporte para PackageUpdateInfo.

SINTAXIS

SetBehaviour

Set-PackageUpdateSetting [-ExcludeModuleFromChecking <string[]>]
 [-IncludeModuleForChecking <string[]>] [-ReportChangeOnMajor <bool>] [-ReportChangeOnMinor <bool>]
 [-ReportChangeOnBuild <bool>] [-ReportChangeOnRevision <bool>] [-UpdateCheckInterval <timespan>]
 [-LastCheck <datetime>] [-LastSuccessfulCheck <datetime>] [-InputObject <Configuration>]
 [-Path <string>] [-PassThru] [-WhatIf] [-Confirm] [<CommonParameters>]

ResetBehaviour

Set-PackageUpdateSetting [-Reset] [-Path <string>] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Configura cómo PackageUpdateInfo evalúa los módulos de PowerShell instalados para detectar actualizaciones disponibles. Usa este comando para controlar qué módulos se incluyen o excluyen de las comprobaciones de actualización, decidir qué cambios de versión deben activar notificaciones de actualización, definir la frecuencia con la que se realizan las comprobaciones de actualización, y restablecer la configuración almacenada a sus valores predeterminados. La configuración se guarda en un archivo JSON y puede aplicarse directamente o pasando un objeto de configuración existente.

EJEMPLOS

EJEMPLO 1

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "MyLocalOnlyModule"

Agrega el módulo “MyLocalOnlyModule” a la lista de exclusión para la comprobación de actualizaciones. Por diseño, esto debe considerarse solo para módulos que no están disponibles en una galería en línea. Esta capacidad está diseñada para evitar comprobaciones de actualización innecesarias en módulos que no existen en una galería en línea.

¡Ya no recibirás información de actualización para el módulo ‘MyLocalOnlyModule’!

Si tienes preocupaciones o problemas de rendimiento debido a una gran cantidad de módulos instalados, es mejor que sigas la práctica de poner el ‘mecanismo de comprobación’ en tu PSProfile como una rutina de trabajo cada vez que inicies una consola. Esto se describe en el ‘uso práctico’ en la página del proyecto en GitHub: https://github.com/AndiBellstedt/PackageUpdateInfo#practical-usage

EJEMPLO 2

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking "Az.*"

Agrega todos los módulos Az. a la lista de exclusión para la comprobación de actualizaciones. Esto debería considerarse una mala práctica, porque ya no recibirás información de actualización para todos los módulos Az. (y pueden cambiar con bastante frecuencia)

EJEMPLO 3

PS C:\> Set-PackageUpdateSetting -IncludeModuleForChecking "*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $true -UpdateCheckInterval "01:00:00"

Restaura el comportamiento predeterminado de comprobación de actualizaciones y los umbrales de notificación manteniendo el intervalo de actualización configurado en una hora.

EJEMPLO 4

PS C:\> Set-PackageUpdateSetting -Reset

Restablece la configuración de actualización de paquetes a los valores predeterminados integrados.

EJEMPLO 5

PS C:\> Get-PackageUpdateSetting | Set-PackageUpdateSetting -PassThru

Actualiza el objeto de configuración actual en memoria y lo devuelve a la canalización para su procesamiento posterior.

PARÁMETROS

-Confirm

Solicita confirmación antes de ejecutar cualquier operación que cambie el estado.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ExcludeModuleFromChecking

Los nombres de los módulos que se excluirán de la comprobación de actualizaciones en la regla predeterminada.

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Los nombres de los módulos que se incluirán en la comprobación de actualizaciones en la regla predeterminada. Por defecto, todos los módulos están incluidos.

El valor predeterminado es: “*”

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Un objeto de configuración devuelto por Get-PackageUpdateSetting que debe actualizarse en su lugar.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastCheck

La marca de tiempo cuando comenzó el último ciclo de comprobación de actualizaciones para los módulos.

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastSuccessfulCheck

La marca de tiempo cuando el último ciclo de comprobación de actualizaciones se completó con éxito.

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Devuelve el objeto de configuración actualizado a la canalización para su procesamiento posterior.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

La ruta completa al archivo de configuración que se debe leer o escribir.

Si se omite este parámetro, el comando usa la ruta de configuración predeterminada del módulo: Linux: “$HOME/.config/powershell/PackageUpdateInfo/PackageUpdateSetting_$($PSEdition)$($PSVersionTable.PSVersion.Major).json” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateSetting$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnBuild

Indica si un cambio en la versión de compilación de un módulo debe activar una notificación de actualización en la regla predeterminada.

Esto significa que Get-PackageUpdateSetting reporta una necesidad de actualización solo cuando cambia el número de versión de compilación de un módulo.

Major Minor Build Revision

0 0 1 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Indica si un cambio en la versión mayor de un módulo debe activar una notificación de actualización en la regla predeterminada.

Esto significa que Get-PackageUpdateSetting reporta una necesidad de actualización solo cuando cambia el número de versión mayor de un módulo.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMinor

Indica si un cambio en la versión menor de un módulo debe activar una notificación de actualización en la regla predeterminada.

Esto significa que Get-PackageUpdateSetting reporta una necesidad de actualización solo cuando cambia el número de versión menor de un módulo.

Major Minor Build Revision

0 1 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Indica si un cambio en la parte de revisión de la versión de un módulo debe activar una notificación de actualización en la regla predeterminada.

Esto significa que Get-PackageUpdateSetting reporta una necesidad de actualización solo cuando cambia el número de revisión de un módulo.

Major Minor Build Revision

1 0 0 0

Type: Boolean
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Reset

Restablece la configuración del módulo a su comportamiento predeterminado.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ResetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-UpdateCheckInterval

El intervalo mínimo de tiempo que debe transcurrir antes de realizar una nueva comprobación de actualización de módulos.

El valor predeterminado es: “01:00:00”

Type: TimeSpan
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Muestra qué pasaría si se ejecutara el comando sin realizar realmente ningún cambio.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

ENTRADAS

PackageUpdate.Configuration

SALIDAS

PackageUpdate.Configuration

NOTAS

Versión : 1.1.0.0 Autor : Andi Bellstedt Fecha : 2026-06-21 Palabras clave : PackageUpdateInfo, Update, Module, Setting

ENLACES RELACIONADOS

packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdatesetting

4.10 - Show-PackageUpdateReleaseNote

SINOPSIS

Muestra las notas de la versión para uno o más módulos de PowerShell.

SINTAXIS

PorObjetoPackageUpdateInfo

Show-PackageUpdateReleaseNote [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

PorObjetoMódulo

Show-PackageUpdateReleaseNote [[-Module] <psmoduleinfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Recupera y muestra las notas de la versión para objetos de información de módulo producidos por Get-PackageUpdateInfo o Import-PackageUpdateInfo, o para objetos de módulo devueltos por Get-Module. Cuando las notas de la versión están disponibles como una URL, el cmdlet intenta resolver y recuperar el contenido para que las notas puedan presentarse directamente al llamador.

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote

Recupera las notas de la versión para cada módulo devuelto por Get-PackageUpdateInfo.

EJEMPLO 2

PS C:\> Get-Module PackageUpdateInfo | Show-PackageUpdateReleaseNote

Recupera las notas de la versión para el módulo PackageUpdateInfo de la sesión actual de PowerShell.

EJEMPLO 3

PS C:\> Get-PackageUpdateInfo -Name PackageUpdateInfo | Show-PackageUpdateReleaseNote

Muestra las notas de la versión para un módulo específico usando la salida de Get-PackageUpdateInfo.

EJEMPLO 4

PS C:\> Get-PackageUpdateInfo | Show-PackageUpdateReleaseNote -WhatIf

Muestra qué módulos se procesarían para la recuperación de notas de la versión sin realizar la operación.

PARÁMETROS

-Confirm

Si este interruptor está activado, se te pedirá confirmación antes de ejecutar cualquier operación que cambie el estado.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Uno o más objetos PackageUpdateInfo de Get-PackageUpdateInfo o Import-PackageUpdateInfo que contienen información de notas de la versión.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Input
ParameterSets:
- Name: ByPackageUpdateInfoObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Module

Uno o más objetos de módulo de Get-Module que contienen metadatos de notas de la versión o una URL de notas de la versión.

Type: PSModuleInfo[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- ModuleName
ParameterSets:
- Name: ByModuleObject
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si este interruptor está activado, no se realiza ninguna acción pero se mostrarán mensajes informativos que explican qué pasaría si se ejecutara el comando.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

ENTRADAS

PackageUpdate.Info[]

System.Management.Automation.PSModuleInfo[]

SALIDAS

PackageUpdate.ReleaseNote

NOTAS

Versión : 1.1.0.0 Autor : Andi Bellstedt Fecha : 2026-06-21 Palabras clave : PackageUpdateInfo, Update, Module, ReleaseNote

ENLACES RELACIONADOS

packageupdateinfo.andibellstedt.com/docs/commands/show-packageupdatereleasenote

Acerca de esta documentación

Acerca del módulo

Recursos

Contribuciones

1 - Visión general

¿Qué hace PackageUpdateInfo?

¿Por qué usar PackageUpdateInfo?

Conveniencia

Automatización

Flexibilidad

Requisitos previos

Instalación

Inicio rápido

Patrón práctico de automatización

Próximos pasos

2 - Mejores prácticas operativas

Comienza con el comportamiento predeterminado

Usa intervalos de actualización para reducir el ruido

Prefiere un inicio de shell no bloqueante

Verifica el alcance explícitamente cuando sea necesario

Diseña reglas cuidadosamente

Usa exportación/importación de manera intencionada

Mantén las notificaciones útiles

3 - Solución de problemas

Obtén diagnósticos útiles primero

Verificación omitida inesperadamente

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

No se devuelven módulos

La exportación falla por errores en la ruta

La importación no devuelve datos

Las notificaciones toast no aparecen

No se pueden agregar o modificar reglas

Problemas con repositorios y red

Flujo de recuperación

4 - Referencia de comandos del módulo

4.1 - Add-PackageUpdateRule

SYNOPSIS

SYNTAX

__AllParameterSets

ALIASES

DESCRIPTION

EXAMPLES

EXAMPLE 1

EXAMPLE 2

EXAMPLE 3

EXAMPLE 4

PARAMETERS

-Confirm

-ExcludeModuleFromChecking

-Id

-IncludeModuleForChecking

-PassThru

-ReportChangeOnBuild

-ReportChangeOnMajor

-ReportChangeOnMinor

-ReportChangeOnRevision

-SettingObject

-WhatIf

CommonParameters

INPUTS

PackageUpdate.Configuration

OUTPUTS

PackageUpdate.ModuleRule

NOTES

RELATED LINKS

4.2 - Export-PackageUpdateInfo

SINOPSIS

SINTAXIS

__AllParameterSets

ALIAS

DESCRIPCIÓN

EJEMPLOS

EJEMPLO 1

EJEMPLO 2

EJEMPLO 3

EJEMPLO 4

PARÁMETROS

-Append

-Confirm

-Encoding