Versión imprimible multipagina. Haga click aquí para imprimir.

Volver a la vista normal de esta página.

Acerca de esta documentación

Esta es la página oficial de documentación para PackageUpdateInfo, un módulo de PowerShell que te ayuda a mantenerte al día con tus módulos instalados verificando todos los módulos de PowerShell instalados localmente y reportando cuáles necesitan una actualización.

Acerca del módulo

PackageUpdateInfo nació de una necesidad del mundo real: hacer un seguimiento de las actualizaciones de módulos en muchos módulos de PowerShell instalados puede ser tedioso y fácil de olvidar. Este módulo cierra esa brecha al verificar automáticamente todos los módulos instalados contra la Galería de PowerShell y presentar una visión clara de las actualizaciones disponibles.

Principios clave de diseño:

  • Multiplataforma — soporta Windows, Linux y macOS
  • Compatibilidad entre ediciones — soporta PowerShell Desktop (5.1+) y Core (7.x)
  • Configurabilidad — personaliza los intervalos de verificación de actualizaciones, reglas de sensibilidad de versiones y exclusiones
  • Compatible con pipeline — se integra de manera natural con la arquitectura de pipeline de PowerShell
  • Soporte de notificaciones — notificaciones de escritorio BurntToast opcionales en Windows

Recursos

Contribuciones

Las contribuciones son bienvenidas. Si encuentras problemas, errores o tienes sugerencias de mejoras, por favor abre un issue o pull request en el repositorio de GitHub.

1 - Visión general

PackageUpdateInfo te ayuda a mantener actualizados los módulos de PowerShell instalados. Compara las versiones locales de los módulos con las versiones de los repositorios en línea configurados (por ejemplo, PSGallery) y reporta cuando hay versiones más nuevas disponibles.

¿Qué hace PackageUpdateInfo?

El módulo puede:

  • Consultar los módulos instalados localmente.
  • Descubrir las versiones actuales en línea.
  • Comparar versiones con sensibilidad configurable (mayor, menor, compilación, revisión).
  • Mostrar una salida enriquecida que incluye enlace al repositorio, notas de lanzamiento, autor y enlaces al proyecto.
  • Exportar resultados para importarlos más tarde y facilitar flujos de trabajo de inicio rápido.

¿Por qué usar PackageUpdateInfo?

Conveniencia

  • Identifica rápidamente módulos desactualizados sin tener que revisar manualmente cada uno.
  • Exporta e importa información de actualizaciones para revisión offline o diferida.
  • Ejecuta comprobaciones de actualización en trabajos en segundo plano.
  • Usa notificaciones emergentes opcionales en Windows.

Automatización

  • Programa comprobaciones de actualización usando tu perfil, tareas programadas o rutinas de inicio.
  • Establece un intervalo de comprobación de actualizaciones para reducir consultas innecesarias a los repositorios.
  • Mantén reglas personalizadas por patrón de módulo para la sensibilidad de actualización.
  • Reutiliza datos exportados previamente para un inicio de shell de baja latencia.

Flexibilidad

  • Incluye o excluye patrones de nombres de módulos.
  • Define el alcance y la precedencia de reglas con reglas predeterminadas y personalizadas.
  • Funciona en Windows, Linux y macOS.
  • Soporta Windows PowerShell 5.1 y PowerShell 7+.

Requisitos previos

  • Windows PowerShell 5.1 o PowerShell 7+.
  • PowerShellGet con acceso a tu repositorio objetivo (por ejemplo, PSGallery).
  • Opcional: módulo BurntToast para notificaciones emergentes en Windows.

Instalación

Instala para todos los usuarios (requiere derechos administrativos):

Install-Module PackageUpdateInfo

Instala para el usuario actual:

Install-Module PackageUpdateInfo -Scope CurrentUser

Inicio rápido

Ejecuta una comprobación interactiva:

Get-PackageUpdateInfo

Muestra solo los módulos que necesitan una actualización:

Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Forzar una comprobación incluso si el intervalo de actualización configurado no ha expirado:

Get-PackageUpdateInfo -Force

Usa notificaciones emergentes (Windows con BurntToast):

Get-PackageUpdateInfo -ShowToastNotification

Patrón práctico de automatización

Exporta datos de actualización en un trabajo en segundo plano e impórtalos al iniciar la shell:

Start-Job -ScriptBlock { Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification | Export-PackageUpdateInfo } | Out-Null
Import-PackageUpdateInfo

Esto mantiene la interacción en el inicio mientras muestra información reciente de actualizaciones.

Próximos pasos

  • Continúa con las mejores prácticas operativas para ajuste, diseño de reglas y automatización.
  • Continúa con la resolución de problemas para errores comunes y flujos de recuperación.

2 - Mejores prácticas operativas

Esta página describe los patrones de operación recomendados para PackageUpdateInfo en herramientas interactivas, perfiles y automatización.

Comienza con el comportamiento predeterminado

Restablece la configuración antes de introducir ajustes personalizados, especialmente en sistemas compartidos:

Set-PackageUpdateSetting -Reset

Inspecciona la configuración y las reglas actuales:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Usa intervalos de actualización para reducir el ruido

Get-PackageUpdateInfo respeta UpdateCheckInterval. Si la última verificación efectiva aún está dentro del intervalo configurado, el cmdlet devuelve temprano.

Establece un intervalo que coincida con tu entorno:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Hours 6)

Usa -Force solo para ejecuciones de verificación ad-hoc:

Get-PackageUpdateInfo -Force

Prefiere un inicio de shell no bloqueante

Un patrón práctico de perfil es:

Start-Job -ScriptBlock {
    Get-PackageUpdateInfo -ShowOnlyNeededUpdate | Export-PackageUpdateInfo
} | Out-Null

Import-PackageUpdateInfo

Por qué esto funciona bien:

  • El inicio sigue siendo rápido porque la importación lee datos en caché.
  • La verificación en línea costosa se ejecuta en segundo plano.
  • Aún obtienes una visibilidad útil de las actualizaciones en cada sesión.

Verifica el alcance explícitamente cuando sea necesario

Usa parámetros de alcance cuando los permisos difieran entre módulos de usuario y del sistema:

Get-PackageUpdateInfo -CurrentUser
Get-PackageUpdateInfo -AllUsers

Usa -Repository en entornos con múltiples repositorios configurados:

Get-PackageUpdateInfo -Repository PSGallery

Diseña reglas cuidadosamente

Usa exclusiones amplias solo cuando sean intencionales. Excluir patrones grandes puede ocultar actualizaciones importantes.

Crea reglas personalizadas enfocadas para módulos con alta rotación:

Add-PackageUpdateRule -IncludeModuleForChecking "Az.*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $false -ReportChangeOnRevision $false

Revisa la precedencia de las reglas listando todas ellas:

Get-PackageUpdateRule -IncludeDefaultRule | Sort-Object Id

Usa exportación/importación de manera intencionada

Las rutas predeterminadas de exportación e importación son específicas de la plataforma e incluyen la edición de PowerShell y la versión principal en el nombre del archivo. Esto ayuda a evitar mezclar datos de diferentes entornos de ejecución.

Opciones comunes de exportación:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat XML
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat JSON
Get-PackageUpdateInfo | Export-PackageUpdateInfo -OutputFormat CSV

Guía recomendada:

  • Usa XML cuando quieras conservar objetos tipados para reimportar.
  • Usa JSON o CSV para informes externos e integración.
  • Usa -IncludeTimeStamp para seguimiento histórico.

Mantén las notificaciones útiles

Usa notificaciones toast solo donde aporten valor:

  • En hosts Windows con BurntToast instalado.
  • En sesiones donde se esperan alertas interactivas.

Para servidores, CI y shells no interactivos, prefiere informes exportados en lugar de notificaciones toast.

3 - Solución de problemas

Utiliza esta guía cuando PackageUpdateInfo no devuelva resultados esperados, omita verificaciones o falle al importar y exportar datos.

Obtén diagnósticos útiles primero

Ejecuta con salida detallada:

Get-PackageUpdateInfo -Verbose

Valida configuraciones y reglas:

Get-PackageUpdateSetting
Get-PackageUpdateRule -IncludeDefaultRule

Verificación omitida inesperadamente

Síntoma:

  • Ves una advertencia de que las verificaciones de actualización se omiten porque el intervalo de comprobación no ha expirado.

Causa:

  • UpdateCheckInterval y LastCheck o LastSuccessfulCheck recientes impiden una nueva comprobación en línea.

Resolución:

Get-PackageUpdateInfo -Force

O reduce el intervalo:

Set-PackageUpdateSetting -UpdateCheckInterval (New-TimeSpan -Minutes 30)

El archivo de configuración falta o está dañado

Síntoma:

  • Get-PackageUpdateSetting advierte que no se encontró el archivo de configuración del módulo, y luego lanza una excepción.

Causa:

  • La ruta del archivo de configuración no existe o contiene JSON inválido.

Resolución:

Set-PackageUpdateSetting -Reset
Get-PackageUpdateSetting

No se devuelven módulos

Síntoma:

  • Get-PackageUpdateInfo no devuelve nada aunque hay módulos instalados.

Causas comunes:

  • Las reglas de inclusión y exclusión filtran todos los módulos.
  • -CurrentUser o -AllUsers filtran los módulos que esperas.
  • El filtrado por repositorio excluye los módulos relevantes.

Pasos de resolución:

Get-PackageUpdateRule -IncludeDefaultRule
Get-PackageUpdateInfo -Force
Get-PackageUpdateInfo -CurrentUser -Force
Get-PackageUpdateInfo -AllUsers -Force

La exportación falla por errores en la ruta

Síntoma:

  • La exportación reporta problemas con rutas o directorios inválidos.

Causa:

  • -Path apunta a un directorio o a una ubicación que no existe sin -Force.

Resolución:

Get-PackageUpdateInfo | Export-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.xml" -Force

La importación no devuelve datos

Síntoma:

  • Import-PackageUpdateInfo no devuelve nada.

Causas comunes:

  • El archivo está vacío o es demasiado pequeño para contener registros.
  • -InputFormat no coincide con el formato exportado.
  • Ruta de archivo incorrecta para la versión y edición en uso.

Resolución:

Import-PackageUpdateInfo -InputFormat XML -Verbose
Import-PackageUpdateInfo -Path "$HOME\PackageUpdateInfo\updates.json" -InputFormat JSON

Las notificaciones toast no aparecen

Síntoma:

  • Se usa -ShowToastNotification, pero no aparece ninguna notificación.

Causas comunes:

  • BurntToast no está instalado.
  • La plataforma host no soporta notificaciones toast de Windows.
  • Ningún módulo en el resultado tiene NeedUpdate = $true.

Resolución:

Install-Module BurntToast -Scope CurrentUser
Get-PackageUpdateInfo -ShowOnlyNeededUpdate -ShowToastNotification -Force

No se pueden agregar o modificar reglas

Síntoma:

  • La adición de una regla falla con Id duplicado, valores de include o exclude.

Causa:

  • Las reglas personalizadas existentes ya contienen los mismos identificadores o patrones.

Resolución:

Get-PackageUpdateRule
Add-PackageUpdateRule -IncludeModuleForChecking "MyModule.*"
Set-PackageUpdateRule -Id 1 -ReportChangeOnRevision $false
Remove-PackageUpdateRule -Id 1

Problemas con repositorios y red

Síntoma:

  • La búsqueda en línea de versiones falla o está incompleta.

Causas comunes:

  • El repositorio no está registrado o no se puede acceder.
  • Problemas temporales de red.

Resolución:

Get-PSRepository
Find-Module PackageUpdateInfo -Repository PSGallery
Get-PackageUpdateInfo -Repository PSGallery -Force

Flujo de recuperación

Si el comportamiento sigue siendo inconsistente, usa esta secuencia de restablecimiento:

Set-PackageUpdateSetting -Reset
Get-PackageUpdateInfo -Force | Export-PackageUpdateInfo
Import-PackageUpdateInfo

4 - Referencia de comandos del módulo

Aquí, puedes encontrar una referencia para todos los comandos del módulo. Esta referencia está diseñada para ayudarte a encontrar rápidamente el comando que necesitas y entender cómo usarlo de manera efectiva.

Al hacer clic en un comando, serás llevado a una página detallada que proporciona información completa sobre el comando, incluyendo su sintaxis, parámetros, ejemplos y cualquier nota o consejo adicional para su uso.

4.1 - Add-PackageUpdateRule

SINOPSIS

Agregar regla para verificar y reportar módulos instalados

SINTAXIS

__AllParameterSets

Add-PackageUpdateRule [[-Id] <int>] [[-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 comando permite declarar cómo se maneja un módulo en los reportes para casos especiales.

Por ejemplo, puedes configurar PackageUpdateInfo para suprimir actualizaciones de revisión en un módulo que se actualiza con frecuencia, de modo que solo se reporten como “actualización necesaria” las actualizaciones de compilación, menor o mayor.

EJEMPLOS

EJEMPLO 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Agrega una nueva regla personalizada para “MyModule” para suprimir notificaciones sobre actualizaciones de revisión del módulo

PARÁMETROS

-Confirm

Si este interruptor está habilitado, se te pedirá 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

Nombres de módulos a excluir de la verificación de actualizaciones

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 Id como identificador 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

Nombres de módulos a incluir en la verificación de actualizaciones Por defecto, todos los módulos están incluidos.

El valor predeterminado es: “*”

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

El objeto regla será enviado a la canalización para procesamiento adicional

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

Reportar cuando cambia la versión de compilación de un módulo

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

Mayor Menor Compilación Revisión

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

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.

Mayor Menor Compilación Revisión

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

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.

Mayor Menor Compilación Revisión

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

Reportar cuando cambia la parte de revisión de un módulo

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

Mayor Menor Compilación Revisión

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

Objeto de configuración recibido desde el comando Get-PackageUpdateSetting Este es un parámetro opcional. Por defecto usará el objeto de configuración predeterminado 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

Si este interruptor está habilitado, no se realizan acciones, pero se mostrarán mensajes informativos que explican qué pasaría si se ejecutara el comando.

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

4.2 - Configurar-ConfiguraciónDeActualizaciónDePaquete

SINOPSIS

Configura las opciones de comportamiento para el módulo 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

Set-PackageUpdateInfo configura las opciones básicas para verificar y reportar la información de actualización en los módulos instalados

EJEMPLOS

EJEMPLO 1

PS C:\> Set-PackageUpdateSetting -ExcludeModuleFromChecking @("") -IncludeModuleForChecking "*" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $true -UpdateCheckInterval "01:00:00"

Restablece el módulo a su comportamiento predeterminado

EJEMPLO 2

PS C:\> Set-PackageUpdateSetting -Reset

Restablece el módulo a su comportamiento predeterminado

PARÁMETROS

-Confirm

Si habilitas este interruptor, se te solicitará 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

Nombres de módulos a excluir 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

Nombres de módulos a incluir en la comprobación de actualizaciones en la regla predeterminada Por defecto, se incluyen todos los módulos.

Valor predeterminado: “*”

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

Objeto de configuración analizado desde el comando Get-PackageUpdateSetting

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-LastCheck

Marca de tiempo de la última comprobación de actualización necesaria en 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

Marca de tiempo de la última comprobación de actualización finalizada

Type: DateTime
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

El objeto de configuración será analizado y enviado a la canalización para procesamiento adicional

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 del archivo donde se almacena la configuración

Este parámetro es opcional, el valor predeterminado de la ruta es: Linux: “$HOME/.local/share/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

Reporta cuando cambia la versión de compilación de un módulo en la regla predeterminada

Esto significa que ‘Get-PackageUpdateSetting’ reporta la necesidad de actualización, 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: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnMajor

Reporta cuando cambia la versión principal de un módulo en la regla predeterminada

Esto significa que ‘Get-PackageUpdateSetting’ reporta la necesidad de actualización, solo cuando cambia la versión principal 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

Reporta cuando cambia la versión menor de un módulo en la regla predeterminada

Esto significa que ‘Get-PackageUpdateSetting’ reporta la 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: SetBehaviour
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ReportChangeOnRevision

Reporta cuando cambia la parte de revisión de un módulo en la regla predeterminada

Esto significa que ‘Get-PackageUpdateSetting’ reporta la necesidad de actualización, cuando cambia la versión 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 el 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 tiempo transcurrido para realizar una nueva comprobación de actualización del módulo

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

Si habilitas este interruptor, no se realizarán acciones, pero se mostrarán mensajes informativos que explican qué sucedería si el comando se ejecutara.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

Parámetros comunes

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

4.3 - Export-PackageUpdateInfo

RESUMEN

Exporta PackageUpdateInfo a un archivo de datos

SINTAXIS

__AllParameterSets

Export-PackageUpdateInfo [[-Path] <string>] -InputObject <Info[]> [-OutputFormat <string>]
 [-Encoding <string>] [-Force] [-Append] [-IncludeTimeStamp] [-PassThru] [-WhatIf] [-Confirm]
 [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Exporta PackageUpdateInfo a un archivo de datos

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateInfo | Export-PackageUpdateInfo

Ejemplo de uso de Export-PackageUpdateInfo

PARÁMETROS

-Append

El archivo de salida no será reemplazado. Toda la información será añadida.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Confirm

Si este interruptor está habilitado, se te pedirá 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: ''

-Encoding

Codificación del archivo para el archivo

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Si el directorio para el archivo no está presente, pero se especifica un directorio distinto al predeterminado, la función intentará crear el directorio.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeTimeStamp

Se añadirá una marca de tiempo a los registros de informació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: ''

-InputObject

El PackageUpdateInfo de la función Get-PackageUpdateInfo.

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OutputFormat

El formato de salida para los datos. Los formatos disponibles son “XML”, “JSON”, “CSV”.

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

Los objetos exportados serán enviados al pipeline para procesamiento adicional.

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 del archivo donde exportar la información. Por favor, especifica un archivo como ruta.

El valor predeterminado de la ruta es: Linux: “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml” Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si este interruptor está habilitado, no se realizarán acciones, pero se mostrarán mensajes informativos que explican qué pasaría si el comando se ejecutara.

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.Info[]

SALIDAS

PackageUpdate.Info

4.4 - Get-PackageUpdateInfo

SINOPSIS

Obtiene información sobre el estado de actualización de los módulos instalados

SINTAXIS

DefaultSet1 (Predeterminado)

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-Force] [<CommonParameters>]

CurrentUser

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-CurrentUser] [-Force] [<CommonParameters>]

AllUsers

Get-PackageUpdateInfo [-Name <string[]>] [-Repository <string[]>] [-ShowOnlyNeededUpdate]
 [-ShowToastNotification] [-AllUsers] [-Force] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Get-PackageUpdateInfo consulta los módulos instalados localmente y los compara con las versiones en línea para verificar si están actualizados

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateInfo

Muestra información de actualización para todos los módulos (CurrentUser y AllUsers). La salida puede ser similar a:

Name Repository VersionInstalled VersionOnline NeedUpdate Path

PSReadline PSGallery 1.2 1.2 False C:\Program Files\WindowsPowerShell\Modules\PSReadline Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

EJEMPLO 2

PS C:\> Get-PackageUpdateInfo -ShowOnlyNeededUpdate

Esto filtrará la salida para mostrar solo los módulos donde NeedUpdate es True. La salida puede ser similar a:

Name Repository VersionInstalled VersionOnline NeedUpdate Path

Pester PSGallery 4.4.0 4.4.2 True C:\Program Files\WindowsPowerShell\Modules\Pester

EJEMPLO 3

PS C:\> "Pester", "PSReadline" | Get-PackageUpdateInfo

Se soporta la canalización. Esto devuelve la información solo para los dos módulos “Pester” y “PSReadline”.

Esto también se puede hacer con el cmdlet Get-Module: Get-Module “Pester”, “PSReadline” | Get-PackageUpdateInfo

PARÁMETROS

-AllUsers

Busca solo módulos en los directorios AllUsers/sistema. Ten en cuenta que se requieren derechos de administrador para actualizar esos módulos.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: AllUsers
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-CurrentUser

Busca solo módulos en el perfil del usuario actual. Esto es útil si estás ejecutando sin derechos de administrador, lo cual siempre deberías hacer como preferencia predeterminada.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: CurrentUser
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Force

Forzar la consulta de información sobre el estado de actualización de los módulos instalados, incluso si el intervalo UpdateCheckInterval desde la última comprobación no ha expirado.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Name

El nombre del módulo a comprobar

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Repository

El repositorio a comprobar

Type: String[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowOnlyNeededUpdate

Este interruptor suprime los módulos que están actualizados en la salida.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Este interruptor muestra notificaciones tipo toast de Windows con información de las notas de la versión en los módulos que necesitan actualización.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
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.

ENTRADAS

System.String[]

SALIDAS

PackageUpdate.Info

4.5 - Get-PackageUpdateRule

SINOPSIS

Obtiene regla(s) para verificar y reportar sobre módulos instalados

SINTAXIS

ShowAll (Predeterminado)

Get-PackageUpdateRule [-IncludeModuleForChecking <string>] [-ExcludeModuleFromChecking <string>]
 [-IncludeDefaultRule] [-SettingObject <Configuration>] [<CommonParameters>]

ById

Get-PackageUpdateRule -Id <int[]> [-SettingObject <Configuration>] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Este comando obtiene la(s) regla(s) personalizada(s) existentes sobre cómo se manejan los módulos en los reportes.

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateRule

Obtiene todas las reglas personalizadas existentes

EJEMPLO 2

PS C:\> Get-PackageUpdateRule -Id 1

Obtiene la regla personalizada con Id 1

PARÁMETROS

-ExcludeModuleFromChecking

Nombres de módulos a excluir de la verificación de actualizaciones

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Exclude
- ExcludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

El Id como identificador para la regla

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeDefaultRule

Muestra la ReglaPredeterminada del objeto de configuración, además de las reglas personalizadas

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-IncludeModuleForChecking

Nombres de módulos a incluir en la verificación de actualizaciones Por defecto, todos los módulos están incluidos.

El valor predeterminado es: “*”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Include
- IncludeModule
ParameterSets:
- Name: ShowAll
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Objeto de configuración pasado desde el comando Get-PackageUpdateSetting Este es un parámetro opcional. Por defecto usará el objeto de configuración predeterminado del módulo.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  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.

ENTRADAS

System.Int32[]

PackageUpdate.Configuration

SALIDAS

PackageUpdate.ModuleRule

4.6 - Get-PackageUpdateSetting

RESUMEN

Configura los ajustes de comportamiento para el módulo PackageUpdateInfo

SINTAXIS

__AllParameterSets

Get-PackageUpdateSetting [[-Path] <string>] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Consulta la configuración básica para verificar y reportar información sobre la vigencia de los módulos instalados

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateSetting

Obtiene la configuración actual del comportamiento de PackageUpdateInfo.

PARÁMETROS

-Path

La ruta del archivo donde se encuentra el archivo de configuración

Este parámetro es opcional, el valor predeterminado de la ruta es: Linux: “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).json”) Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).json”)

Type: String
DefaultValue: $script:ModuleSettingPath
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  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.

SALIDAS

PackageUpdate.Configuration

4.7 - Import-PackageUpdateInfo

RESUMEN

Importa PackageUpdateInfo desde un archivo de datos

SINTAXIS

__AllParameterSets

Import-PackageUpdateInfo [[-Path] <string>] [-ShowToastNotification] [-InputFormat <string>]
 [-Encoding <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Importa PackageUpdateInfo desde un archivo de datos previamente exportado con la función Export-PackageUpdateInfo.

EJEMPLOS

EJEMPLO 1

PS C:\> Import-PackageUpdateInfo

Intenta importar el archivo predeterminado “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo_$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

PARÁMETROS

-Confirm

Si este interruptor está activado, se te pedirá 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: ''

-Encoding

Codificación del archivo para el archivo

Type: String
DefaultValue: default
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputFormat

El formato de salida para los datos
Los formatos disponibles son “XML”, “JSON”, “CSV”

Type: String
DefaultValue: XML
SupportsWildcards: false
Aliases:
- Format
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Path

La ruta del archivo desde donde importar la información.
Por favor, especifica un archivo como ruta.

El valor predeterminado de la ruta es:
Linux: “$HOME/.local/share/powershell/PackageUpdateInfo/PackageUpdateInfo_$($PSEdition)$($PSVersionTable.PSVersion.Major).xml”
Windows: “$HOME\AppData\Local\Microsoft\Windows\PowerShell\PackageUpdateInfo$($PSEdition)_$($PSVersionTable.PSVersion.Major).xml”

Type: String
DefaultValue: ''
SupportsWildcards: false
Aliases:
- FullName
- FilePath
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ShowToastNotification

Este interruptor muestra bonitas notificaciones tipo toast de Windows con información de notas de la versión en módulos que necesitan actualización.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases:
- ToastNotification
- Notify
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si este interruptor está activado, no se realizan acciones pero se mostrarán mensajes informativos que explican qué pasaría si se ejecutara el comando.

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

SALIDAS

PackageUpdate.Info

4.8 - Mostrar-NotasDeLanzamientoDeActualizaciónDePaquete

SINOPSIS

Mostrar notas de lanzamiento de un módulo

SINTAXIS

PorObjetoDeInformaciónDeActualizaciónDePaquete

Mostrar-NotasDeLanzamientoDeActualizaciónDePaquete [[-InputObject] <Info[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

PorObjetoDeMódulo

Mostrar-NotasDeLanzamientoDeActualizaciónDePaquete [[-Module] <psmoduleinfo[]>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Mostrar notas de lanzamiento de un módulo.

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateInfo | Mostrar-NotasDeLanzamientoDeActualizaciónDePaquete

Obtener notas de lanzamiento de objetos PackageUpdateInfo

EJEMPLO 2

PS C:\> Get-Module PackageUpdateInfo | Mostrar-NotasDeLanzamientoDeActualizaciónDePaquete

Obtener notas de lanzamiento de un módulo

PARÁMETROS

-Confirmar

Si se habilita este interruptor, se te pedirá confirmación antes de ejecutar cualquier operación que cambie el estado.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- cf
ParameterSets:
- Name: (Todos)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-ObjetoDeEntrada

Objeto(s) de entrada de Get-PackageUpdateInfo o Import-PackageUpdateInfo para mostrar notas de lanzamiento

Type: Info[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- Input
ParameterSets:
- Name: PorObjetoDeInformaciónDeActualizaciónDePaquete
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Módulo

Objeto(s) de entrada de Get-Module para mostrar notas de lanzamiento

Type: PSModuleInfo[]
DefaultValue: ''
SupportsWildcards: false
Aliases:
- ModuleName
ParameterSets:
- Name: PorObjetoDeMódulo
  Position: 0
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-QuéPasaría

Si se habilita este interruptor, no se realizarán acciones, pero se mostrarán mensajes informativos que explican qué pasaría si el comando se ejecutara.

Type: SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases:
- wi
ParameterSets:
- Name: (Todos)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

ParámetrosComunes

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.

ENTRADAS

PackageUpdate.Info[]

System.Management.Automation.PSModuleInfo[]

SALIDAS

PackageUpdate.ReleaseNote

4.9 - Remove-PackageUpdateRule

SINOPSIS

Elimina regla(s) para verificar y reportar sobre módulos instalados

SINTAXIS

PorId (Predeterminado)

Remove-PackageUpdateRule -Id <int[]> [-Force] [-PassThru] [-SettingObject <Configuration>] [-WhatIf]
 [-Confirm] [<CommonParameters>]

PorObjetoDeEntrada

Remove-PackageUpdateRule -InputObject <ModuleRule[]> [-Force] [-PassThru]
 [-SettingObject <Configuration>] [-WhatIf] [-Confirm] [<CommonParameters>]

ALIAS

Este cmdlet tiene los siguientes alias,

DESCRIPCIÓN

Este comando elimina regla(s) personalizada(s) existentes sobre cómo se maneja un módulo en los reportes.

EJEMPLOS

EJEMPLO 1

PS C:\> Get-PackageUpdateRule | Remove-PackageUpdateRule

Elimina todas las reglas personalizadas para el manejo de actualizaciones de módulos.

PARÁMETROS

-Confirm

Si este interruptor está habilitado, se te pedirá 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: ''

-Force

Si se especifica, no se solicitará confirmación al usuario.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-Id

El Id de la regla que se eliminará

Type: Int32[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ById
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-InputObject

Objeto de configuración recibido del comando Get-PackageUpdateSetting.
Este es un parámetro opcional.

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

El objeto regla será enviado al pipeline para procesamiento adicional.

Type: SwitchParameter
DefaultValue: False
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-SettingObject

Objeto de configuración del comando Get-PackageUpdateSetting.
Este es un parámetro opcional.
Por defecto usará el objeto de configuración predeterminado del módulo.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si este interruptor está habilitado, no se realizarán acciones, pero se mostrarán mensajes informativos que explican qué sucedería si se ejecutara el comando.

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.

ENTRADAS

System.Int32[]

PackageUpdate.ModuleRule[]

PackageUpdate.Configuration

SALIDAS

PackageUpdate.ModuleRule

4.10 - Set-PackageUpdateRule

SINOPSIS

Establece una regla para verificar y reportar sobre módulos instalados

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 comando permite editar reglas existentes sobre cómo se maneja un módulo en los reportes.

Por ejemplo, puedes configurar PackageUpdateInfo para suprimir actualizaciones de revisión en un módulo que se actualiza con frecuencia, de modo que solo se reporten como “actualización necesaria” las actualizaciones de compilación, menor o mayor.

EJEMPLOS

EJEMPLO 1

PS C:\> Add-PackageUpdateRule -IncludeModuleForChecking "MyModule" -ReportChangeOnMajor $true -ReportChangeOnMinor $true -ReportChangeOnBuild $true -ReportChangeOnRevision $false

Agrega una nueva regla personalizada para “MyModule” para suprimir notificaciones sobre actualizaciones de revisión del módulo

PARÁMETROS

-Confirm

Si este interruptor está habilitado, se te pedirá 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

Nombres de módulos a excluir de la verificación de actualizaciones

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 Id como identificador para la regla

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

Nombres de módulos a incluir en la verificación de actualizaciones Por defecto, todos los módulos están incluidos.

El valor predeterminado es: “*”

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 modificar

Type: ModuleRule[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: ByInputObject
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PassThru

El objeto regla será enviado al pipeline para procesamiento adicional

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

Reporta cuando cambia la versión de compilación de un módulo

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

Mayor Menor Compilación Revisión

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

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

Mayor Menor Compilación Revisión

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

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

Mayor Menor Compilación Revisión

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

Reporta cuando cambia la parte de revisión de un módulo

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

Mayor Menor Compilación Revisión

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

Objeto de configuración pasado desde el comando Get-PackageUpdateSetting Este es un parámetro opcional. Por defecto usará el objeto de configuración predeterminado del módulo.

Type: Configuration
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-WhatIf

Si este interruptor está habilitado, no se realizan acciones pero se mostrarán mensajes informativos que explican qué pasaría si se ejecutara el comando.

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