# Add-PackageUpdateRule LLMS index: [llms.txt](/llms.txt) --- ## SYNOPSIS Agrega una regla personalizada que controla cómo se reportan las actualizaciones de módulos. ## SYNTAX ### __AllParameterSets ``` Add-PackageUpdateRule [[-Id] ] [[-IncludeModuleForChecking] ] [[-ExcludeModuleFromChecking] ] [[-ReportChangeOnMajor] ] [[-ReportChangeOnMinor] ] [[-ReportChangeOnBuild] ] [[-ReportChangeOnRevision] ] [[-SettingObject] ] [-PassThru] [-WhatIf] [-Confirm] [] ``` ## 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 ```powershell 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 ```powershell 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 ```powershell 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 ```powershell 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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. ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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 ```yaml 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. ```yaml 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. ```yaml 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](https://go.microsoft.com/fwlink/?LinkID=113216). ## INPUTS ### PackageUpdate.Configuration ## OUTPUTS ### PackageUpdate.ModuleRule ## NOTES Version : 1.1.0.0 Author : Andi Bellstedt Date : 2026-06-21 Keywords : PackageUpdateInfo, Update, Module, Rule ## RELATED LINKS - [packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule](https://packageupdateinfo.andibellstedt.com/docs/commands/add-packageupdaterule/)