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, например PS XYZ:\> . Дополнительные сведения см. в дополнительных сведениях о том, как начать работу.

Примеры

Пример 1. Скачивание обновлений программного обеспечения

Эта команда получает все обновления программного обеспечения, скачаемые сайтом.

Get-CMSoftwareUpdate -IsContentProvisioned $True

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

Эта команда сначала получает объект группы обновления программного обеспечения с именем TestSUgroup10. Затем оператор конвейера передает объект Get-CMSoftwareUpdate. Результатом является список всех обновлений программного обеспечения для группы обновления программного обеспечения.

Get-CMSoftwareUpdateGroup -Name "TestSUgroup10" | Get-CMSoftwareUpdate

Параметры

-ArticleId

Укажите ID статьи обновления программного обеспечения. Например, 4571687.

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

-BulletinId

Укажите ID бюллетеня обновления программного обеспечения. Например, MS18-952.

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

-Category

Укажите категорию обновления программного обеспечения. Чтобы получить объект категории, используйте кодлет Get-CMSoftwareUpdateCategory.

Type:	IResultObject[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-CategoryName

Укажите массив имен категорий для обновлений программного обеспечения.

Type:	String[]
Aliases:	CategoryNames
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DatePostedMax

Укажите последнюю дату выпуска обновления программного обеспечения.

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

-DatePostedMin

Укажите дату выпуска обновления программного обеспечения.

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

-DateRevisedMax

Укажите последнюю дату, когда обновление программного обеспечения было пересмотрено.

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

-DateRevisedMin

Укажите дату, когда обновление программного обеспечения было пересмотрено.

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

-DisableWildcardHandling

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

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

-EulaExist

Установите этот параметр $true для фильтрации результатов для всех обновлений, которые имеют лицензионный договор.

Type:	Boolean
Aliases:	EulaExists
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Fast

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

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

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

-ForceWildcardHandling

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

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

-Id

Указывает ID обновления программного обеспечения. Это значение является CI_ID, например 143404 .

Type:	Int32
Aliases:	CIId, CI_ID
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-IncludeUpgrade

Добавьте этот параметр, чтобы включить обновления программного обеспечения в категорию обновления.

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

-IsContentProvisioned

Установите этот параметр для фильтрации результатов для всех обновлений, для которых сайт $true скачал контент.

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

-IsDeployed

Установите этот параметр $true для фильтрации результатов для всех развернутых обновлений.

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

-IsExpired

Установите этот параметр для фильтрации результатов для всех обновлений $true с истекшим сроком действия.

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

-IsLatest

Установите этот параметр для фильтрации результатов для последней $true версии обновления программного обеспечения.

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

-IsOfflineServiceable

Установите этот параметр $true для фильтрации результатов для всех обновлений, которые могут работать в автономном режиме. Вы можете использовать средство командной строки DISM для впрыскиванию этих обновлений в образ ОС.

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

-IsSuperseded

Установите этот параметр для фильтрации результатов для всех обновлений, которые $true будут выданы.

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

-IsUserDefined

Установите этот параметр для фильтрации результатов для всех обновлений, $true определенных пользователем.

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

-Name

Укажите имя обновления программного обеспечения. Этот параметр сравнивает с атрибутом локализованного имени отображения.

Можно использовать символы под диктовки:

*: Несколько символов
?: Одиночный символ

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

-OnlyExpired

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

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

-UpdateGroup

Укажите объект группового обновления программного обеспечения. Чтобы получить этот объект, используйте группу Get-CMSoftwareUpdateGroup.

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-UpdateGroupId

Укажите массив ID групп обновления программного обеспечения. Это значение — CI_ID или config Item ID группы обновления программного обеспечения. Например, 107078.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UpdateGroupName

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

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Vendor

Применяется к версии 2010 и более поздней версии. Укажите имя поставщика обновлений программного обеспечения. Поставщик большинства обновлений программного обеспечения "Microsoft" . При настройке сторонних обновлений программного обеспечения используйте это значение для фильтрации для других поставщиков обновлений.

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

-Серьезность

Укажите серьезность обновления программного обеспечения.

Type:	CustomSeverityType
Accepted values:	None, Low, Moderate, Important, Critical
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject[]

IResultObject

Примечания

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