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.
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