Get-CMSoftwareUpdateCategory
Получение классификации обновлений программного обеспечения или продукта.
Синтаксис
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.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Fast
Добавьте этот параметр, чтобы не обновлять отложенные свойства автоматически. Отложенные свойства содержат значения, которые относительно неэффективны для извлечения. Получение этих свойств может вызвать дополнительный сетевой трафик и снизить производительность командлета.
Если этот параметр не используется, командлет выводит предупреждение. Чтобы отключить это предупреждение, задайте .$CMPSSuppressFastNotUsedCheck = $true
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Id
Укажите идентификатор получаемой категории.
Тип: | String |
Aliases: | CategoryInstanceID |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Name
Укажите имя получаемой категории.
Тип: | String |
Aliases: | LocalizedCategoryInstanceName, CategoryName |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | True |
-TypeName
Укажите тип получаемой категории. К общим значениям относятся следующие типы:
- UpdateClassification
- Организация
- ProductFamily
- Продукт
Тип: | String |
Aliases: | CategoryTypeName |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | True |
-UniqueId
Укажите уникальный идентификатор для получаемой категории. Это значение является именем типа с ИДЕНТИФИКАТОРом GUID для категории. Пример: UpdateClassification:77835c8d-62a7-41f5-82ad-f28d1af1e3b1
Тип: | String |
Aliases: | CategoryInstance_UniqueID |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
None
Выходные данные
IResultObject[]
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_UpdateCategoryInstance класс WMI сервера.