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 сервера.