Remove-CMSoftwareUpdateFromPackage
Удалите обновление из пакета обновления программного обеспечения.
Синтаксис
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdateId <String[]>
-SoftwareUpdatePackageId <String>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdate <IResultObject[]>
-SoftwareUpdatePackageId <String>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdate <IResultObject[]>
-SoftwareUpdatePackageName <String>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdate <IResultObject[]>
-SoftwareUpdatePackage <IResultObject>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdateId <String[]>
-SoftwareUpdatePackageName <String>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdateId <String[]>
-SoftwareUpdatePackage <IResultObject>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdateName <String[]>
-SoftwareUpdatePackageId <String>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdateName <String[]>
-SoftwareUpdatePackageName <String>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMSoftwareUpdateFromPackage
-SoftwareUpdateName <String[]>
-SoftwareUpdatePackage <IResultObject>
[-RefreshDistributionPoint]
[-Force]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот командлет, чтобы удалить указанное обновление программного обеспечения из пакета.
Примечание.
Запустите командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Удаление обновления и обновление содержимого
В этом примере сначала возвращается идентификатор обновления программного обеспечения. Затем он получает пакет обновления программного обеспечения по его идентификатору. Последняя команда удаляет обновление из пакета. Он обновляет содержимое в точке распространения и не запрашивает подтверждение.
$SU0 = "Bing Bar 7.1 (KB2673770)"
$SU0_ID = ( Get-CMSoftwareUpdate -Name $SU0 -Fast ).CI_ID
$suppkg1 = Get-CMSoftwareUpdateDeploymentPackage -Id "XYZ0000C"
Remove-CMSoftwareUpdateFromPackage -SoftwareUpdatePackageId $suppkg1.PackageID -SoftwareUpdateId $SU0_ID -RefreshDistributionPoint -Force
Пример 2. Удаление двух обновлений, но не обновление содержимого
В этом примере сначала определяются имена двух обновлений программного обеспечения. Затем он получает пакет обновления программного обеспечения по его идентификатору. Последняя команда удаляет оба обновления программного обеспечения из пакета. Так как эта команда не включает параметр Force , она запрашивает подтверждение. Так как он не включает параметр RefreshDistributionPoint , необходимо вручную обновить содержимое в точках распространения.
$SU1 = "Bing Bar 7.1 (KB2673771)"
$SU2 = "Bing Bar 7.1 (KB2673772)"
$suppkg1 = Get-CMSoftwareUpdateDeploymentPackage -Id "XYZ0000C"
Remove-CMSoftwareUpdateFromPackage -SoftwareUpdatePackage $suppkg1 -SoftwareUpdateName ($SU1, $SU2)
Параметры
-Confirm
Перед запуском командлет запросит подтверждение.
Тип: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-Force
Добавьте этот параметр, чтобы выполнить команду без запроса подтверждения.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Тип: | SwitchParameter |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-RefreshDistributionPoint
Добавьте этот параметр, чтобы обновить содержимое пакета в точках распространения. Если этот параметр не включен, необходимо вручную обновить точки распространения. Дополнительные сведения см. в разделе Управление распределенным содержимым.
Тип: | SwitchParameter |
Aliases: | RefreshDistributionPointAfterRemoveSoftwareUpdateFromPackage |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SoftwareUpdate
Укажите массив объектов обновления программного обеспечения для удаления из пакета. Чтобы получить этот объект, используйте командлет Get-CMSoftwareUpdate .
Тип: | IResultObject[] |
Aliases: | SoftwareUpdates |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-SoftwareUpdateId
Укажите массив идентификаторов для обновлений программного обеспечения, которые необходимо удалить из пакета. Это значение является CI_ID обновления, например 1584792
.
Тип: | String[] |
Aliases: | SoftwareUpdateIds |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SoftwareUpdateName
Укажите массив имен для обновлений программного обеспечения, которые необходимо удалить из пакета.
Тип: | String[] |
Aliases: | SoftwareUpdateNames |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | True |
-SoftwareUpdatePackage
Укажите объект пакета обновления программного обеспечения, из которого следует удалить обновления. Чтобы получить этот объект, используйте командлет Get-CMSoftwareUpdateDeploymentPackage .
Тип: | IResultObject |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | True |
Принять подстановочные знаки: | False |
-SoftwareUpdatePackageId
Укажите идентификатор пакета обновлений программного обеспечения, из которого необходимо удалить обновления. Это значение является стандартным идентификатором пакета, например XYZ0035E
.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-SoftwareUpdatePackageName
Укажите имя пакета обновлений программного обеспечения, с которого будут удалены обновления.
Тип: | String |
Position: | Named |
Default value: | None |
Обязательно: | True |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
Тип: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Обязательно: | False |
Принять входные данные конвейера: | False |
Принять подстановочные знаки: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
System.Object