Get-CMSoftwareUpdate
Получите обновление программного обеспечения.
Синтаксис
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>] Описание
Используйте этот командлет для получения одного или нескольких обновлений программного обеспечения.
Дополнительные сведения см. в документации по управлению обновлениями программного обеспечения в основной документации.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Получение скачанных обновлений программного обеспечения
Эта команда получает все обновления программного обеспечения, скачанные сайтом.
Get-CMSoftwareUpdate -IsContentProvisioned $TrueПример 2. Получение обновлений программного обеспечения по группам обновлений
Эта команда сначала получает объект группы обновлений программного обеспечения с именем TestSUgroup10. Затем он использует оператор конвейера для передачи объекта в Get-CMSoftwareUpdate. Результатом будет список всех обновлений программного обеспечения для группы обновлений программного обеспечения.
Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdateПараметры
-ArticleId
Укажите идентификатор статьи обновления программного обеспечения. Например, 4571687.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | True |
-BulletinId
Укажите идентификатор бюллетеня обновления программного обеспечения. Например, MS18-952.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | True |
-Category
Укажите категорию обновления программного обеспечения. Чтобы получить объект категории, используйте командлет Get-CMSoftwareUpdateCategory .
| Тип: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-CategoryName
Укажите массив имен категорий для обновлений программного обеспечения.
| Тип: | String[] |
| Aliases: | CategoryNames |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DatePostedMax
Укажите последнюю дату выпуска обновления программного обеспечения.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DatePostedMin
Укажите самую раннюю дату выпуска обновления программного обеспечения.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DateRevisedMax
Укажите последнюю дату изменения обновления программного обеспечения.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DateRevisedMin
Укажите самую раннюю дату изменения обновления программного обеспечения.
| Тип: | DateTime |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-EulaExist
Присвойте этому параметру значение , $true чтобы отфильтровать результаты по всем обновлениям, имеющим лицензионное соглашение.
| Тип: | Boolean |
| Aliases: | EulaExists |
| 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
Указывает идентификатор обновления программного обеспечения. Это значение является CI_ID, например 143404.
| Тип: | Int32 |
| Aliases: | CIId, CI_ID |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IncludeUpgrade
Добавьте этот параметр, чтобы включить обновления программного обеспечения в категорию обновления.
| Тип: | SwitchParameter |
| Aliases: | IncludeUpgrades |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsContentProvisioned
Задайте для этого параметра значение , $true чтобы отфильтровать результаты всех обновлений, для которых сайт скачал содержимое.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsDeployed
Присвойте этому параметру значение , $true чтобы отфильтровать результаты для всех развернутых обновлений.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsExpired
Присвойте этому параметру значение , $true чтобы отфильтровать результаты по всем обновлениям, срок действия которых истек.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsLatest
Задайте для этого параметра значение , $true чтобы отфильтровать результаты для последней версии обновления программного обеспечения.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsOfflineServiceable
Задайте для этого параметра значение , $true чтобы отфильтровать результаты для всех обновлений, которые доступны для автономного обслуживания. Для внедрения этих обновлений в образ ОС можно использовать программу командной строки DISM.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsSuperseded
Присвойте этому параметру значение , $true чтобы отфильтровать результаты по всем обновлениям, которые заменяются.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-IsUserDefined
Присвойте этому параметру значение , $true чтобы фильтровать результаты для всех определяемых пользователем обновлений.
| Тип: | Boolean |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Name
Укажите имя обновления программного обеспечения. Этот параметр сравнивает локализованный атрибут отображаемого имени.
Можно использовать подстановочные знаки:
-
*: несколько символов -
?: один символ
| Тип: | String |
| Aliases: | LocalizedDisplayName |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | True |
-OnlyExpired
Добавьте этот параметр только для поиска обновлений программного обеспечения с истекшим сроком действия.
| Тип: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Severity
Укажите серьезность обновления программного обеспечения.
| Тип: | CustomSeverityType |
| Допустимые значения: | None, Low, Moderate, Important, Critical |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UpdateGroup
Укажите объект группы обновления программного обеспечения. Чтобы получить этот объект, используйте командлет Get-CMSoftwareUpdateGroup .
| Тип: | IResultObject |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | True |
| Принять подстановочные знаки: | False |
-UpdateGroupId
Укажите массив идентификаторов групп обновлений программного обеспечения. Это значение является идентификатором CI_ID или элемента конфигурации группы обновлений программного обеспечения. Например, 107078.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-UpdateGroupName
Укажите массив имен групп обновлений программного обеспечения.
| Тип: | String[] |
| Position: | Named |
| Default value: | None |
| Обязательно: | True |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
-Vendor
Применяется к версии 2010 и более поздним. Укажите имя поставщика обновлений программного обеспечения. Поставщиком большинства обновлений программного обеспечения является "Microsoft". Если вы настраиваете сторонние обновления программного обеспечения, используйте это значение для фильтрации по другим поставщикам обновлений.
| Тип: | String |
| Position: | Named |
| Default value: | None |
| Обязательно: | False |
| Принять входные данные конвейера: | False |
| Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
IResultObject[]
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе класс WMI сервера SMS_SoftwareUpdate.