Get-CMSoftwareUpdate
Obtener una actualización de software.
Syntax
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 más actualizaciones de software.
Para obtener más información, vea La documentación de administración de actualizaciones de software en los documentos principales.
Nota
Ejecute los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>
. Para obtener más información, vea getting started.
Ejemplos
Ejemplo 1: Obtener actualizaciones de software descargadas
Este comando obtiene todas las actualizaciones de software que el sitio ha descargado.
Get-CMSoftwareUpdate -IsContentProvisioned $True
Ejemplo 2: Obtener 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 del 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
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-BulletinId
Especifique el identificador de boletín de una actualización de software. Por ejemplo, MS18-952
.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Category
Especifique la categoría de una actualización de software. Para obtener un objeto de categoría, use el cmdlet Get-CMSoftwareUpdateCategory.
Type: | IResultObject[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CategoryName
Especifique una matriz de nombres de categoría para las actualizaciones de software.
Type: | String[] |
Aliases: | CategoryNames |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatePostedMax
Especifique la fecha más reciente en la que se publicó una actualización de software.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DatePostedMin
Especifique la fecha más temprana en que se publicó una actualización de software.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateRevisedMax
Especifique la fecha más reciente en la que se revisó una actualización de software.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DateRevisedMin
Especifique la fecha más temprana en la que se revisó una actualización de software.
Type: | DateTime |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EulaExist
Establezca este parámetro en $true
para filtrar los resultados de todas las actualizaciones que tienen un contrato de licencia.
Type: | Boolean |
Aliases: | EulaExists |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Fast
Agregue este parámetro para no actualizar automáticamente las propiedades diferida. Las propiedades diferida contienen valores que son relativamente ineficientes para recuperar. Obtener estas propiedades puede provocar tráfico de red adicional y disminuir el rendimiento del cmdlet.
Si no usa este parámetro, el cmdlet muestra una advertencia. Para deshabilitar esta advertencia, establezca $CMPSSuppressFastNotUsedCheck = $true
.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica el identificador de una actualización de software. Este valor es el CI_ID, por ejemplo 143404
.
Type: | Int32 |
Aliases: | CIId, CI_ID |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeUpgrade
Agregue este parámetro para incluir actualizaciones de software en la categoría de actualización.
Type: | SwitchParameter |
Aliases: | IncludeUpgrades |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsContentProvisioned
Establezca este parámetro para filtrar los resultados de todas las actualizaciones para las $true
que el sitio ha descargado contenido.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsDeployed
Establezca este parámetro en $true
para filtrar los resultados de todas las actualizaciones implementadas.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsExpired
Establezca este parámetro en $true
para filtrar los resultados de todas las actualizaciones que han expirado.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsLatest
Establezca este parámetro en $true
para filtrar los resultados de la versión más reciente de la actualización de software.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsOfflineServiceable
Establezca este parámetro en para filtrar los resultados de todas las $true
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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsSuperseded
Establezca este parámetro en $true
para filtrar los resultados de todas las actualizaciones reemplazadas.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IsUserDefined
Establezca este parámetro en para filtrar los resultados de todas las actualizaciones $true
definidas por el usuario.
Type: | Boolean |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | String |
Aliases: | LocalizedDisplayName |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-OnlyExpired
Agregue este parámetro solo para buscar actualizaciones de software expiradas.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Severity
Especifique la gravedad de la actualización de software.
Type: | CustomSeverityType |
Accepted values: | None, Low, Moderate, Important, Critical |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateGroup
Especifique el objeto de grupo de actualización de software. Para obtener este objeto, use el cmdlet Get-CMSoftwareUpdateGroup.
Type: | IResultObject |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-UpdateGroupId
Especifique una matriz de IDs de grupos de actualización de software. Este valor es el CI_ID o identificador de elemento de configuración del grupo de actualización de software. Por ejemplo, 107078
.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpdateGroupName
Especifique una matriz de nombres de grupos de actualización de software.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Vendor
Se aplica a la versión 2010 y versiones posteriores. Especifique el nombre del proveedor de actualización 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.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 server WMI class.