Set-CMSoftwareUpdatePointComponent
Настройте компонент сайта для точки обновления программного обеспечения.
Синтаксис
Set-CMSoftwareUpdatePointComponent
[-AddCompany <String[]>]
[-AddLanguageSummaryDetail <String[]>]
[-AddLanguageUpdateFile <String[]>]
[-AddProduct <String[]>]
[-AddProductFamily <String[]>]
[-AddUpdateClassification <String[]>]
[-ContentFileOption <ContentFileOptions>]
[-DefaultWsusServer <String>]
[-EnableCallWsusCleanupWizard <Boolean>]
[-EnableManualCertManagement <Boolean>]
[-EnableSyncFailureAlert <Boolean>]
[-EnableThirdPartyUpdates <Boolean>]
[-FeatureUpdateMaxRuntimeMins <Int32>]
[-ImmediatelyExpireSupersedence <Boolean>]
[-ImmediatelyExpireSupersedenceForFeature <Boolean>]
[-NonFeatureUpdateMaxRuntimeMins <Int32>]
[-PassThru]
[-RemoveCompany <String[]>]
[-RemoveLanguageSummaryDetail <String[]>]
[-RemoveLanguageUpdateFile <String[]>]
[-RemoveProduct <String[]>]
[-RemoveProductFamily <String[]>]
[-RemoveUpdateClassification <String[]>]
[-ReportingEvent <ReportingEventType>]
[-Schedule <IResultObject>]
[-SiteCode <String>]
[-SynchronizeAction <SynchronizeActionType>]
[-UpstreamSourceLocation <String>]
[-WaitMonth <Int32>]
[-WaitMonthForFeature <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSoftwareUpdatePointComponent
[-AddCompany <String[]>]
[-AddLanguageSummaryDetail <String[]>]
[-AddLanguageUpdateFile <String[]>]
[-AddProduct <String[]>]
[-AddProductFamily <String[]>]
[-AddUpdateClassification <String[]>]
[-ContentFileOption <ContentFileOptions>]
[-DefaultWsusServer <String>]
[-EnableCallWsusCleanupWizard <Boolean>]
[-EnableManualCertManagement <Boolean>]
[-EnableSyncFailureAlert <Boolean>]
[-EnableThirdPartyUpdates <Boolean>]
[-FeatureUpdateMaxRuntimeMins <Int32>]
[-ImmediatelyExpireSupersedence <Boolean>]
[-ImmediatelyExpireSupersedenceForFeature <Boolean>]
-Name <String>
[-NonFeatureUpdateMaxRuntimeMins <Int32>]
[-PassThru]
[-RemoveCompany <String[]>]
[-RemoveLanguageSummaryDetail <String[]>]
[-RemoveLanguageUpdateFile <String[]>]
[-RemoveProduct <String[]>]
[-RemoveProductFamily <String[]>]
[-RemoveUpdateClassification <String[]>]
[-ReportingEvent <ReportingEventType>]
[-Schedule <IResultObject>]
[-SynchronizeAction <SynchronizeActionType>]
[-UpstreamSourceLocation <String>]
[-WaitMonth <Int32>]
[-WaitMonthForFeature <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Set-CMSoftwareUpdatePointComponent
[-AddCompany <String[]>]
[-AddLanguageSummaryDetail <String[]>]
[-AddLanguageUpdateFile <String[]>]
[-AddProduct <String[]>]
[-AddProductFamily <String[]>]
[-AddUpdateClassification <String[]>]
[-ContentFileOption <ContentFileOptions>]
[-DefaultWsusServer <String>]
[-EnableCallWsusCleanupWizard <Boolean>]
[-EnableManualCertManagement <Boolean>]
[-EnableSyncFailureAlert <Boolean>]
[-EnableThirdPartyUpdates <Boolean>]
[-FeatureUpdateMaxRuntimeMins <Int32>]
[-ImmediatelyExpireSupersedence <Boolean>]
[-ImmediatelyExpireSupersedenceForFeature <Boolean>]
-InputObject <IResultObject>
[-NonFeatureUpdateMaxRuntimeMins <Int32>]
[-PassThru]
[-RemoveCompany <String[]>]
[-RemoveLanguageSummaryDetail <String[]>]
[-RemoveLanguageUpdateFile <String[]>]
[-RemoveProduct <String[]>]
[-RemoveProductFamily <String[]>]
[-RemoveUpdateClassification <String[]>]
[-ReportingEvent <ReportingEventType>]
[-Schedule <IResultObject>]
[-SynchronizeAction <SynchronizeActionType>]
[-UpstreamSourceLocation <String>]
[-WaitMonth <Int32>]
[-WaitMonthForFeature <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Используйте этот командлет, чтобы настроить компонент сайта для точки обновления программного обеспечения. Используйте его после добавления точки обновления программного обеспечения, например с помощью командлета Add-CMSoftwareUpdatePoint . Этот командлет также можно использовать для перенастройки существующей точки обновления программного обеспечения.
Компонент точки обновления программного обеспечения взаимодействует с сервером Windows Server Update Services (WSUS) для настройки параметров обновления, запроса синхронизации с вышестоящим источником обновления и синхронизации обновлений из базы данных WSUS с базой данных сервера сайта на центральном сайте.
Дополнительные сведения см. в разделе Компоненты сайта для Configuration Manager.
Примечание.
Выполните командлеты Configuration Manager с диска сайта Configuration Manager, например PS XYZ:\>
. Дополнительные сведения см. в статье Начало работы.
Примеры
Пример 1. Изменение компонента сайта точки обновления программного обеспечения
Первая команда получает объект компонента точки обновления программного обеспечения с сайта XYZ . Команда сохраняет объект в переменной $supComp .
Вторая команда создает объект schedule для повторения каждые три дня.
Затем в этом примере параметры командлета объединяются в переменную параметров . Это не обязательно для splat параметры, это просто упрощает чтение параметров для такой длинной командной строки.
Последняя команда изменяет общие свойства компонента точки обновления программного обеспечения.
$supComp = Get-CMSoftwareUpdatePointComponent -SiteSystemServerName 'sup1.contoso.com' -SiteCode 'XYZ'
$schedule = New-CMSchedule -RecurCount 3 -RecurInterval Days -Start "2020/1/7 12:00:00"
$addLang = "Dutch"
$removeLang = "English"
$parameters = @{
InputObject = $supComp
DefaultWsusServer = 'sup.contoso.com'
SynchronizeAction = 'SynchronizeFromMicrosoftUpdate'
ReportingEvent = 'CreateAllWsusReportingEvents'
RemoveUpdateClassification = "Update Rollups"
AddUpdateClassification = "Critical Updates"
Schedule = $schedule
EnableSyncFailureAlert = $true
ImmediatelyExpireSupersedence = $true
AddLanguageUpdateFile = $addLang
AddLanguageSummaryDetails = $addLang
RemoveLanguageUpdateFile = $removeLang
RemoveLanguageSummaryDetails = $removeLang
}
Set-CMSoftwareUpdatePointComponent @parameters
Пример 2. Отключение синхронизации точек обновления программного обеспечения
Следующая команда удаляет расписание из компонента сайта, что отключает синхронизацию.
Set-CMSoftwareUpdatePointComponent -Name "Contoso-SiteSysSrv.Western.Contoso.com" -Schedule $null
Параметры
-AddCompany
Этот параметр представляет собой строковый массив имен компаний. Используйте этот параметр для синхронизации списка продуктов всей компании.
Чтобы удалить всю компанию из этого списка, используйте параметр RemoveCompany .
Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.
Type: | String[] |
Aliases: | AddCompanies |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddLanguageSummaryDetail
Этот параметр представляет собой массив строк имен языков. Используйте этот параметр, чтобы скачать сведения сводки для указанных языков.
Чтобы удалить языки из этого списка, используйте параметр RemoveLanguageSummaryDetail .
Дополнительные сведения см. в разделе Планирование параметров синхронизации — языки.
Type: | String[] |
Aliases: | AddLanguageSummaryDetails |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddLanguageUpdateFile
Этот параметр представляет собой массив строк имен языков. Используйте этот параметр, чтобы скачать файл обновления программного обеспечения для указанных языков.
Чтобы удалить языки из этого списка, используйте параметр RemoveLanguageUpdateFile .
Дополнительные сведения см. в разделе Планирование параметров синхронизации — языки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddProduct
Этот параметр представляет собой строковый массив имен продуктов. Используйте этот параметр для синхронизации продуктов.
Чтобы удалить продукт из этого списка, используйте параметр RemoveProduct .
Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.
Type: | String[] |
Aliases: | AddProducts |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddProductFamily
Этот параметр представляет собой строковый массив имен семейств продуктов. Используйте этот параметр для синхронизации списка продуктов семейства продуктов.
Чтобы удалить все семейство продуктов из этого списка, используйте параметр RemoveProductFamily .
Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.
Type: | String[] |
Aliases: | AddProductFamilies |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AddUpdateClassification
Этот параметр представляет собой строковый массив классификаций обновлений. Используйте этот параметр для синхронизации определенных классификаций обновлений программного обеспечения.
Чтобы удалить классификацию из этого списка, используйте параметр RemoveUpdateClassification .
Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Перед запуском командлет запросит подтверждение.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContentFileOption
Используйте этот параметр, чтобы настроить загрузку файлов обновлений точкой обновления программного обеспечения. Файлы экспресс-установки обеспечивают меньшую загрузку и более быструю установку на компьютерах, так как скачиваются и устанавливаются только необходимые файлы. Это большие файлы, которые увеличивают время загрузки серверов сайта и точек распространения.
FullFilesOnly
: скачивание полных файлов для всех утвержденных обновленийExpressForWindows10Only
: скачайте полные файлы для всех утвержденных обновлений и файлы экспресс-установки для Windows 10 или более поздней версии.
Type: | ContentFileOptions |
Accepted values: | FullFilesOnly, ExpressForWindows10Only |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultWsusServer
Укажите полное доменное имя сервера WSUS.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Этот параметр обрабатывает подстановочные знаки как литеральные символы. Вы не можете объединить его с ForceWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableCallWsusCleanupWizard
Задайте для этого параметра значение , $true
чтобы разрешить выполнение задач очистки WSUS после синхронизации. Дополнительные сведения см. в разделе Обслуживание обновлений программного обеспечения.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableManualCertManagement
Задайте для этого параметра значение , $true
чтобы вручную управлять сертификатом подписи WSUS для сторонних обновлений. Этот параметр зависит от параметра EnableThirdPartyUpdates .
Дополнительные сведения см. в разделе Включение сторонних обновлений.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableSyncFailureAlert
Присвойте этому параметру значение , $true
чтобы разрешить компоненту создавать оповещение при сбое синхронизации.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableThirdPartyUpdates
Задайте для этого параметра значение $true
Включить обновления стороннего программного обеспечения. Можно также использовать параметр EnableManualCertManagement .
Дополнительные сведения см. в разделе Включение сторонних обновлений.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FeatureUpdateMaxRuntimeMins
Укажите целочисленное значение для максимального количества времени по умолчанию, необходимого для завершения установки обновления программного обеспечения. Это значение по умолчанию можно переопределить для определенного обновления. Этот параметр влияет только на новые синхронизированные обновления. Этот параметр применяется только к обновлениям компонентов Windows.
Чтобы настроить максимальное время выполнения для Office 365 обновлений и обновлений, не относящихся к функциям, для Windows, используйте параметр NonFeatureUpdateMaxRuntimeMins.
Дополнительные сведения см. в разделе Планирование параметров синхронизации.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Этот параметр обрабатывает подстановочные знаки и может привести к непредвиденному поведению (не рекомендуется). Его нельзя объединить с DisableWildcardHandling.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmediatelyExpireSupersedence
Задайте для этого параметра значение $true
, чтобы немедленно истекать срок действия обновления программного обеспечения, когда его заменяет другое обновление или по истечении указанного периода времени.
Если для этого параметра задано $False
значение , укажите количество месяцев, в течение которых нужно ждать истечения срока действия, с помощью параметра WaitMonth .
Некоторые обновления никогда не истекают, например обновления определений.
При изменении этого параметра сайт запускает полную синхронизацию.
Чтобы настроить это поведение для обновлений компонентов Windows, используйте параметр ImmediatelyExpireSupersedenceForFeature .
Type: | Boolean |
Aliases: | ImmediatelyExpireSupersedenceForNonFeature |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ImmediatelyExpireSupersedenceForFeature
Задайте для этого параметра значение $true
, чтобы немедленно истекать срок действия обновления компонентов Windows, когда его заменяет другое обновление или через указанный период времени.
Если для этого параметра задано $False
значение , укажите количество месяцев, в течение которых требуется дождаться истечения срока действия, с помощью параметра WaitMonthForFeature .
При изменении этого параметра сайт запускает полную синхронизацию.
Чтобы настроить это поведение для обновлений, не относящихся к функциям, используйте параметр ImmediatelyExpireSupersedence .
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Укажите объект компонента сайта точки обновления программного обеспечения для настройки. Чтобы получить этот объект, используйте командлет Get-CMSoftwareUpdatePointComponent .
Type: | IResultObject |
Aliases: | Site, SiteComponent |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Укажите имя сервера системы сайта с ролью точки обновления программного обеспечения.
Type: | String |
Aliases: | SiteName |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NonFeatureUpdateMaxRuntimeMins
Укажите целочисленное значение для максимального количества времени по умолчанию, необходимого для завершения установки обновления программного обеспечения. Это значение по умолчанию можно переопределить для определенного обновления. Этот параметр влияет только на новые синхронизированные обновления. Этот параметр применяется только к обновлениям Office 365 и обновлениям, не относящихся к функциям Windows.
Чтобы настроить максимальное время выполнения для обновлений компонентов Windows, используйте параметр FeatureUpdateMaxRuntimeMins .
Дополнительные сведения см. в разделе Планирование параметров синхронизации.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PassThru
Добавьте этот параметр, чтобы вернуть объект, представляющий элемент, с которым вы работаете. По умолчанию этот командлет не может создавать выходные данные.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveCompany
Этот параметр представляет собой строковый массив имен компаний. Используйте этот параметр, чтобы не синхронизировать весь список продуктов компании.
Чтобы добавить в этот список всю компанию, используйте параметр AddCompany .
Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.
Type: | String[] |
Aliases: | RemoveCompanies |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveLanguageSummaryDetail
Этот параметр представляет собой массив строк имен языков. Используйте этот параметр, чтобы не скачивать сведения сводки для указанных языков.
Чтобы добавить языки в этот список, используйте параметр AddLanguageSummaryDetail .
Дополнительные сведения см. в разделе Планирование параметров синхронизации — языки.
Type: | String[] |
Aliases: | RemoveLanguageSummaryDetails |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveLanguageUpdateFile
Этот параметр представляет собой массив строк имен языков. Используйте этот параметр, чтобы не загружать файл обновления программного обеспечения для указанных языков.
Чтобы добавить языки в этот список, используйте параметр AddLanguageUpdateFile .
Дополнительные сведения см. в разделе Планирование параметров синхронизации — языки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveProduct
Этот параметр представляет собой строковый массив имен продуктов. Используйте этот параметр, чтобы не синхронизировать продукты.
Чтобы добавить продукт в этот список, используйте параметр AddProduct .
Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.
Type: | String[] |
Aliases: | RemoveProducts |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveProductFamily
Этот параметр представляет собой строковый массив имен семейств продуктов. Используйте этот параметр, чтобы не синхронизировать список продуктов семейства продуктов.
Чтобы добавить в этот список все семейство продуктов, используйте параметр AddProductFamily .
Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.
Type: | String[] |
Aliases: | RemoveProductFamilies |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RemoveUpdateClassification
Этот параметр представляет собой строковый массив классификаций обновлений. Используйте этот параметр, чтобы не синхронизировать определенные классификации обновлений программного обеспечения.
Чтобы добавить классификацию в этот список, используйте параметр AddUpdateClassification .
Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReportingEvent
Укажите, создает ли агент клиентский компонент Центра обновления Windows (WUA) на клиентах сообщения о событиях для отчетов WSUS. Configuration Manager не использует эти события. Не создавайте эти события, если они не требуются для других применений.
Type: | ReportingEventType |
Accepted values: | DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Schedule
Укажите объект Schedule для включения синхронизации. Чтобы отключить синхронизацию, задайте для этого параметра значение $null
.
Чтобы получить объект schedule, используйте командлет New-CMSchedule .
Type: | IResultObject |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SiteCode
Укажите трехзначный код для сайта, на котором будет настроен компонент точки обновления программного обеспечения.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SynchronizeAction
Укажите источник синхронизации для этой точки обновления программного обеспечения.
Если выбрано значение SynchronizeFromAnUpstreamDataSourceLocation
, укажите расположение источника данных с помощью параметра UpstreamSourceLocation .
Дополнительные сведения см. в разделе Планирование параметров синхронизации.
Type: | SynchronizeActionType |
Accepted values: | SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UpstreamSourceLocation
Укажите вышестоящее расположение данных в качестве URL-адреса. Пример: https://wsusserver.contoso.com:8531
Чтобы использовать это расположение, укажите SynchronizeFromAnUpstreamDataSourceLocation
для параметра SynchronizeAction .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WaitMonth
Задайте целочисленное значение для количества месяцев ожидания до истечения срока действия обновления программного обеспечения после замены другого обновления.
Этот параметр зависит от параметра ImmediatelyExpireSupersedence .
Type: | Int32 |
Aliases: | WaitMonthForNonFeature |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WaitMonthForFeature
Задайте целочисленное значение для количества месяцев ожидания до истечения срока действия обновления компонентов Windows после замены другого обновления.
Этот параметр зависит от параметра ImmediatelyExpireSupersedenceForFeature .
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Выходные данные
IResultObject
Примечания
Дополнительные сведения об этом возвращаемом объекте и его свойствах см . в разделе SMS_SCI_Component класс WMI сервера.
Связанные ссылки
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по