Set-PackageUpdateSetting

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

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: ''

-InputObject

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

• packageupdateinfo.andibellstedt.com/docs/commands/set-packageupdatesetting