Get-CMSoftwareUpdateCategory

  • Ссылка
Модуль:
ConfigurationManager

Получение классификации обновлений программного обеспечения или продукта.

Синтаксис

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>]

Описание

Используйте этот командлет, чтобы получить объект для классификации обновлений программного обеспечения или продукта. Метаданные обновлений программного обеспечения извлекаются в процессе синхронизации в Configuration Manager на основе параметров, указанных в свойствах компонента точки обновления программного обеспечения. Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Чтобы отфильтровать результаты, возвращаемые этим командлетом, используйте свойства CategoryTypeName и IsSubscribed . Типы категорий включают UpdateClassification, Company, ProductFamily и Product. Если свойство IsSubscribed имеет значение True, сайт настраивается для синхронизации этой категории.

Примечание.

Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.

Примеры

Пример 1. Отображение подписанных классификаций

В этом примере сайт запрашивает все классификации обновлений программного обеспечения, которые он синхронизирует.

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

Чтобы изменить эту команду для возврата списка классификаций, которые сайт не синхронизирует, добавьте оператор not (!) перед ссылкой на свойство IsSubscribed . Пример: !$_.IsSubscribed

Пример 2. Подсчет категорий по типу

В этом примере подсчитывается количество категорий сайта для каждого типа. Это позволяет определить, не синхронизирована ли точка обновления программного обеспечения с вышестоящим источником.

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

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

Пример 3. Отображение продуктов для семейства продуктов Office

В этом примере сначала возвращается категория семейства продуктов для Office, а затем используется идентификатор экземпляра для получения всех дочерних категорий.

$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

Пример 4. Получение всех обновлений программного обеспечения в категории клиента Office 365

В этом примере сначала возвращается категория продукта для клиента Office 365, а затем возвращается все обновления программного обеспечения в этой категории.

$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

Параметры

-DisableWildcardHandling

Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Fast

Добавьте этот параметр, чтобы не обновлять отложенные свойства автоматически. Отложенные свойства содержат значения, которые относительно неэффективны для извлечения. Получение этих свойств может привести к дополнительному сетевому трафику и снижению производительности командлетов.

Если этот параметр не используется, командлет выводит предупреждение. Чтобы отключить это предупреждение, задайте .$CMPSSuppressFastNotUsedCheck = $true

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Укажите идентификатор получаемой категории.

Type:String
Aliases:CategoryInstanceID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Укажите имя получаемой категории.

Type:String
Aliases:LocalizedCategoryInstanceName, CategoryName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-TypeName

Укажите тип получаемой категории. К общим значениям относятся следующие типы:

  • UpdateClassification
  • Организация
  • ProductFamily
  • Продукт
Type:String
Aliases:CategoryTypeName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-UniqueId

Укажите уникальный идентификатор для получаемой категории. Это значение является именем типа с ИДЕНТИФИКАТОРом GUID для категории. Пример: UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1

Type:String
Aliases:CategoryInstance_UniqueID
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Входные данные

None

Выходные данные

IResultObject[]

IResultObject

Примечания

Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе класс WMI сервера SMS_UpdateCategoryInstance.