Get-CMSoftwareUpdate

Ссылка

Модуль:: ConfigurationManager

Получите обновление программного обеспечения.

Синтаксис

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.

Поделиться через