Compartir a través de

Get-CMSoftwareUpdate

  • Referencia
Módulo:
ConfigurationManager

Obtenga una actualización de software.

Sintaxis

Get-CMSoftwareUpdate
   [-ArticleId <String>]
   [-BulletinId <String>]
   [-Category <IResultObject[]>]
   [-CategoryName <String[]>]
   [-DatePostedMax <DateTime>]
   [-DatePostedMin <DateTime>]
   [-DateRevisedMax <DateTime>]
   [-DateRevisedMin <DateTime>]
   [-EulaExist <Boolean>]
   [-Fast]
   [-IncludeUpgrade]
   [-IsContentProvisioned <Boolean>]
   [-IsDeployed <Boolean>]
   [-IsExpired <Boolean>]
   [-IsLatest <Boolean>]
   [-IsOfflineServiceable <Boolean>]
   [-IsSuperseded <Boolean>]
   [-IsUserDefined <Boolean>]
   [-Name <String>]
   [-OnlyExpired]
   [-Severity <CustomSeverityType>]
   [-Vendor <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -Id <Int32>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroupId <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdate
   [-Fast]
   -UpdateGroupName <String[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obtener una o varias actualizaciones de software.

Para obtener más información, consulte la documentación de administración de actualizaciones de software en los documentos principales.

Nota:

Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.

Ejemplos

Ejemplo 1: Obtención de actualizaciones de software descargadas

Este comando obtiene todas las actualizaciones de software que el sitio ha descargado.

Get-CMSoftwareUpdate -IsContentProvisioned $True

Ejemplo 2: Obtención de actualizaciones de software por grupo de actualizaciones

Este comando obtiene primero el objeto de grupo de actualización de software denominado TestSUgroup10. A continuación, usa el operador de canalización para pasar el objeto a Get-CMSoftwareUpdate. El resultado es la lista de todas las actualizaciones de software para el grupo de actualizaciones de software.

Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate

Parámetros

-ArticleId

Especifique el identificador de artículo de una actualización de software. Por ejemplo, 4571687.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-BulletinId

Especifique el id. de boletín de una actualización de software. Por ejemplo, MS18-952.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Category

Especifique la categoría de una actualización de software. Para obtener un objeto de categoría, use el cmdlet Get-CMSoftwareUpdateCategory .

Tipo:IResultObject[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-CategoryName

Especifique una matriz de nombres de categoría para las actualizaciones de software.

Tipo:String[]
Alias:CategoryNames
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatePostedMax

Especifique la fecha más reciente en que se publicó una actualización de software.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DatePostedMin

Especifique la fecha más temprana en que se publicó una actualización de software.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DateRevisedMax

Especifique la fecha más reciente en que se revisó una actualización de software.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DateRevisedMin

Especifique la fecha más temprana en que se revisó una actualización de software.

Tipo:DateTime
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EulaExist

Establezca este parámetro $true en para filtrar los resultados de todas las actualizaciones que tienen un contrato de licencia.

Tipo:Boolean
Alias:EulaExists
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Fast

Agregue este parámetro para no actualizar automáticamente las propiedades diferidas. Las propiedades diferidas contienen valores relativamente ineficaces para recuperar. La obtención de estas propiedades puede provocar tráfico de red adicional y reducir el rendimiento del cmdlet.

Si no usa este parámetro, el cmdlet muestra una advertencia. Para deshabilitar esta advertencia, establezca $CMPSSuppressFastNotUsedCheck = $true.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Id

Especifica el identificador de una actualización de software. Este valor es el CI_ID, por ejemplo 143404.

Tipo:Int32
Alias:CIId, CI_ID
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IncludeUpgrade

Agregue este parámetro para incluir actualizaciones de software en la categoría de actualización.

Tipo:SwitchParameter
Alias:IncludeUpgrades
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsContentProvisioned

Establezca este parámetro $true en para filtrar los resultados de todas las actualizaciones para las que el sitio ha descargado contenido.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsDeployed

Establezca este parámetro $true en para filtrar los resultados de todas las actualizaciones que se implementan.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsExpired

Establezca este parámetro $true en para filtrar los resultados de todas las actualizaciones que han expirado.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsLatest

Establezca este parámetro $true en para filtrar los resultados de la versión más reciente de la actualización de software.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsOfflineServiceable

Establezca este parámetro $true en para filtrar los resultados de todas las actualizaciones que se pueden usar sin conexión. Puede usar la herramienta de línea de comandos DISM para insertar estas actualizaciones en una imagen del sistema operativo.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsSuperseded

Establezca este parámetro $true en para filtrar los resultados de todas las actualizaciones reemplazadas.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IsUserDefined

Establezca este parámetro $true en para filtrar los resultados de todas las actualizaciones definidas por el usuario.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifique el nombre de una actualización de software. Este parámetro se compara con el atributo de nombre para mostrar localizado.

Puede usar caracteres comodín:

  • *: varios caracteres
  • ?: carácter único
Tipo:String
Alias:LocalizedDisplayName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-OnlyExpired

Agregue este parámetro para buscar solo actualizaciones de software expiradas.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Severity

Especifique la gravedad de la actualización de software.

Tipo:CustomSeverityType
Valores aceptados:None, Low, Moderate, Important, Critical
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UpdateGroup

Especifique el objeto de grupo de actualizaciones de software. Para obtener este objeto, use el cmdlet Get-CMSoftwareUpdateGroup .

Tipo:IResultObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-UpdateGroupId

Especifique una matriz de identificadores de grupos de actualizaciones de software. Este valor es el CI_ID o id. de elemento de configuración del grupo de actualizaciones de software. Por ejemplo, 107078.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UpdateGroupName

Especifique una matriz de nombres de grupos de actualizaciones de software.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Vendor

Se aplica a la versión 2010 y versiones posteriores. Especifique el nombre del proveedor de actualizaciones de software. El proveedor de la mayoría de las actualizaciones de software es "Microsoft". Si configura actualizaciones de software de terceros, use este valor para filtrar por otros proveedores de actualizaciones.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Salidas

IResultObject[]

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_SoftwareUpdate clase WMI de servidor.