Set-PackageUpdateRule

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

SYNOPSIS

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

SYNTAX

ById (Predeterminado)

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

ByInputObject

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

ALIASES

Este cmdlet tiene los siguientes alias,

DESCRIPTION

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 proporcionado mediante InputObject, y puede devolver la regla actualizada cuando se especifica -PassThru.

EXAMPLES

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 en major, minor y build.

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 en major y revision se consideren actualizaciones relevantes.

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.

PARAMETERS

-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. Si 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 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 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 build hace que la regla reporte que se necesita una actualización.

Reporta cuando la versión build cambia para un módulo

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

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 de la versión major hace que la regla reporte que se necesita una actualización.

Reporta cuando la versión major cambia para un módulo

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

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 de la versión minor hace que la regla reporte que se necesita una actualización.

Reporta cuando la versión minor cambia para un módulo

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

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 la versión revision hace que la regla reporte que se necesita una actualización.

Reporta cuando la parte revision cambia para un módulo

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

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. Si se omite, el cmdlet 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

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.

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