Add-PackageUpdateRule

For AI agents: a documentation index is available at /llms.txt; a markdown version of this page is available at /es/docs/commands/add-packageupdaterule/index.md.

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

RELATED LINKS

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