Get-CMSoftwareUpdate
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 $TrueEjemplo 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-CMSoftwareUpdatePará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.