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.
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.
PackageUpdate.Configuration
OUTPUTS
PackageUpdate.ModuleRule
NOTES
Version : 1.1.0.0
Author : Andi Bellstedt
Date : 2026-06-21
Keywords : PackageUpdateInfo, Update, Module, Rule
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: ''
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: ''
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
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
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
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
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.
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
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: ''
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
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.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
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>]
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: ''
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.
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
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: ''
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
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)
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 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: ''
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
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
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
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: ''
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
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
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