Compartir a través de

Get-CMSoftwareUpdateCategory

  • Referencia
Módulo:
ConfigurationManager

Obtenga una clasificación de actualización de software o un producto.

Sintaxis

Get-CMSoftwareUpdateCategory
   [-Fast]
   [-Name <String>]
   [-TypeName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdateCategory
   [-Fast]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSoftwareUpdateCategory
   [-Fast]
   -UniqueId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use este cmdlet para obtener un objeto para una clasificación de actualización de software o un producto. Los metadatos de las actualizaciones de software se recuperan durante el proceso de sincronización en Configuration Manager en función de la configuración que especifique en las propiedades del componente de punto de actualización de software. Para obtener más información, consulte Configuración de clasificaciones y productos para sincronizar.

Para filtrar los resultados que devuelve este cmdlet, use las propiedades CategoryTypeName e IsSubscribed . Los tipos de categoría incluyen UpdateClassification, Company, ProductFamily y Product. Cuando la propiedad IsSubscribed es True, el sitio está configurado para sincronizar esa categoría.

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: Mostrar clasificaciones suscritas

En este ejemplo se consulta al sitio todas las clasificaciones de actualización de software que está sincronizando.

Get-CMSoftwareUpdateCategory -Fast -TypeName "UpdateClassification" | Where-Object { $_.IsSubscribed } | Select-Object LocalizedCategoryInstanceName

Para cambiar este comando para devolver la lista de clasificaciones que el sitio no está sincronizando, agregue el operador not (!) antes de la referencia a la propiedad IsSubscribed . Por ejemplo: !$_.IsSubscribed

Ejemplo 2: Recuento de categorías por tipo

En este ejemplo se cuenta cuántas categorías tiene el sitio para cada tipo. Este recuento puede ayudarle a determinar si el punto de actualización de software no está sincronizado con el origen ascendente.

Get-CMSoftwareUpdateCategory -Fast | Group-Object -Property CategoryTypeName

Count Name
----- ----
   13 UpdateClassification
    7 Company
   59 ProductFamily
  338 Product

Ejemplo 3: Mostrar productos para la familia de productos de Office

En este ejemplo se obtiene primero la categoría de familia de productos para Office y, a continuación, se usa su identificador de instancia para obtener todas las categorías secundarias.

$officeFamily = Get-CMSoftwareUpdateCategory -Fast -TypeName "ProductFamily" | Where-Object { $_.LocalizedCategoryInstanceName -eq "Office" }

Get-CMSoftwareUpdateCategory -Fast | Where-Object ParentCategoryInstanceId -eq $officeFamily.CategoryInstanceID | Select-Object LocalizedCategoryInstanceName,CategoryTypeName

LocalizedCategoryInstanceName         CategoryTypeName
-----------------------------         ----------------
Dictionary Updates for Microsoft IMEs Product
New Dictionaries for Microsoft IMEs   Product
Office 2002/XP                        Product
Office 2003                           Product
Office 2007                           Product
Office 2010                           Product
Office 2013                           Product
Office 2016                           Product
Office 365 Client                     Product
Office 2019                           Product

Ejemplo 4: Obtención de todas las actualizaciones de software en la categoría Cliente de Office 365

En este ejemplo se obtiene primero la categoría de producto para el cliente de Office 365 y, a continuación, se obtienen todas las actualizaciones de software de esa categoría.

$cat = Get-CMSoftwareUpdateCategory -Fast -TypeName "Product" | Where-Object { $_.LocalizedCategoryInstanceName -eq "Office 365 Client" }

Get-CMSoftwareUpdate -Fast -Category $cat | Select-Object ArticleID,LocalizedDisplayName,IsDeployed,IsSuperseded,NumTotal,NumMissing

Parámetros

-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

-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

Especifique el identificador de la categoría que se va a obtener.

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

-Name

Especifique el nombre de la categoría que se va a obtener.

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

-TypeName

Especifique el tipo de categoría que se va a obtener. Los valores comunes incluyen los siguientes tipos:

  • UpdateClassification
  • Company
  • Familia de productos
  • Producto
Tipo:String
Alias:CategoryTypeName
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-UniqueId

Especifique el identificador único de la categoría que se va a obtener. Este valor es el nombre de tipo con un GUID para la categoría. Por ejemplo: UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

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

Entradas

None

Salidas

IResultObject[]

IResultObject

Notas

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