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


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 .

Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Тип:String[]
Aliases:AddCompanies
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddLanguageSummaryDetail

Этот параметр представляет собой массив строк имен языков. Используйте этот параметр, чтобы скачать сведения сводки для указанных языков.

Чтобы удалить языки из этого списка, используйте параметр RemoveLanguageSummaryDetail .

Дополнительные сведения см. в разделе Планирование параметров синхронизации — языки.

Тип:String[]
Aliases:AddLanguageSummaryDetails
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddLanguageUpdateFile

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

Чтобы удалить языки из этого списка, используйте параметр RemoveLanguageUpdateFile .

Дополнительные сведения см. в разделе Планирование параметров синхронизации — языки.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddProduct

Этот параметр представляет собой строковый массив имен продуктов. Используйте этот параметр для синхронизации продуктов.

Чтобы удалить продукт из этого списка, используйте параметр RemoveProduct .

Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Тип:String[]
Aliases:AddProducts
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddProductFamily

Этот параметр представляет собой строковый массив имен семейств продуктов. Используйте этот параметр для синхронизации списка продуктов семейства продуктов.

Чтобы удалить все семейство продуктов из этого списка, используйте параметр RemoveProductFamily .

Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Тип:String[]
Aliases:AddProductFamilies
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-AddUpdateClassification

Этот параметр представляет собой строковый массив классификаций обновлений. Используйте этот параметр для синхронизации определенных классификаций обновлений программного обеспечения.

Чтобы удалить классификацию из этого списка, используйте параметр RemoveUpdateClassification .

Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Confirm

Перед запуском командлет запросит подтверждение.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ContentFileOption

Используйте этот параметр, чтобы настроить загрузку файлов обновлений точкой обновления программного обеспечения. Файлы экспресс-установки обеспечивают меньшую загрузку и более быструю установку на компьютерах, так как скачиваются и устанавливаются только необходимые файлы. Это большие файлы, которые увеличивают время загрузки серверов сайта и точек распространения.

  • FullFilesOnly: скачивание полных файлов для всех утвержденных обновлений
  • ExpressForWindows10Only: скачайте полные файлы для всех утвержденных обновлений и файлы экспресс-установки для Windows 10 или более поздней версии.
Тип:ContentFileOptions
Допустимые значения:FullFilesOnly, ExpressForWindows10Only
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DefaultWsusServer

Укажите полное доменное имя сервера WSUS.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-DisableWildcardHandling

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableCallWsusCleanupWizard

Задайте для этого параметра значение , $true чтобы разрешить выполнение задач очистки WSUS после синхронизации. Дополнительные сведения см. в разделе Обслуживание обновлений программного обеспечения.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableManualCertManagement

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

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

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableSyncFailureAlert

Присвойте этому параметру значение , $true чтобы разрешить компоненту создавать оповещение при сбое синхронизации.

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-EnableThirdPartyUpdates

Задайте для этого параметра значение $trueВключить обновления стороннего программного обеспечения. Можно также использовать параметр EnableManualCertManagement .

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

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-FeatureUpdateMaxRuntimeMins

Укажите целочисленное значение для максимального количества времени по умолчанию, необходимого для завершения установки обновления программного обеспечения. Это значение по умолчанию можно переопределить для определенного обновления. Этот параметр влияет только на новые синхронизированные обновления. Этот параметр применяется только к обновлениям компонентов Windows.

Чтобы настроить максимальное время выполнения для Office 365 обновлений и обновлений, не относящихся к функциям, для Windows, используйте параметр NonFeatureUpdateMaxRuntimeMins.

Дополнительные сведения см. в разделе Планирование параметров синхронизации.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ForceWildcardHandling

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ImmediatelyExpireSupersedence

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

Если для этого параметра задано $False значение , укажите количество месяцев, в течение которых нужно ждать истечения срока действия, с помощью параметра WaitMonth .

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

При изменении этого параметра сайт запускает полную синхронизацию.

Чтобы настроить это поведение для обновлений компонентов Windows, используйте параметр ImmediatelyExpireSupersedenceForFeature .

Тип:Boolean
Aliases:ImmediatelyExpireSupersedenceForNonFeature
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ImmediatelyExpireSupersedenceForFeature

Задайте для этого параметра значение $true , чтобы немедленно истекать срок действия обновления компонентов Windows, когда его заменяет другое обновление или через указанный период времени.

Если для этого параметра задано $False значение , укажите количество месяцев, в течение которых требуется дождаться истечения срока действия, с помощью параметра WaitMonthForFeature .

При изменении этого параметра сайт запускает полную синхронизацию.

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

Тип:Boolean
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-InputObject

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

Тип:IResultObject
Aliases:Site, SiteComponent
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-Name

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

Тип:String
Aliases:SiteName
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-NonFeatureUpdateMaxRuntimeMins

Укажите целочисленное значение для максимального количества времени по умолчанию, необходимого для завершения установки обновления программного обеспечения. Это значение по умолчанию можно переопределить для определенного обновления. Этот параметр влияет только на новые синхронизированные обновления. Этот параметр применяется только к обновлениям Office 365 и обновлениям, не относящихся к функциям Windows.

Чтобы настроить максимальное время выполнения для обновлений компонентов Windows, используйте параметр FeatureUpdateMaxRuntimeMins .

Дополнительные сведения см. в разделе Планирование параметров синхронизации.

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-PassThru

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

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveCompany

Этот параметр представляет собой строковый массив имен компаний. Используйте этот параметр, чтобы не синхронизировать весь список продуктов компании.

Чтобы добавить в этот список всю компанию, используйте параметр AddCompany .

Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Тип:String[]
Aliases:RemoveCompanies
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveLanguageSummaryDetail

Этот параметр представляет собой массив строк имен языков. Используйте этот параметр, чтобы не скачивать сведения сводки для указанных языков.

Чтобы добавить языки в этот список, используйте параметр AddLanguageSummaryDetail .

Дополнительные сведения см. в разделе Планирование параметров синхронизации — языки.

Тип:String[]
Aliases:RemoveLanguageSummaryDetails
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveLanguageUpdateFile

Этот параметр представляет собой массив строк имен языков. Используйте этот параметр, чтобы не загружать файл обновления программного обеспечения для указанных языков.

Чтобы добавить языки в этот список, используйте параметр AddLanguageUpdateFile .

Дополнительные сведения см. в разделе Планирование параметров синхронизации — языки.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveProduct

Этот параметр представляет собой строковый массив имен продуктов. Используйте этот параметр, чтобы не синхронизировать продукты.

Чтобы добавить продукт в этот список, используйте параметр AddProduct .

Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Тип:String[]
Aliases:RemoveProducts
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveProductFamily

Этот параметр представляет собой строковый массив имен семейств продуктов. Используйте этот параметр, чтобы не синхронизировать список продуктов семейства продуктов.

Чтобы добавить в этот список все семейство продуктов, используйте параметр AddProductFamily .

Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Тип:String[]
Aliases:RemoveProductFamilies
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RemoveUpdateClassification

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

Чтобы добавить классификацию в этот список, используйте параметр AddUpdateClassification .

Дополнительные сведения см. в разделе Настройка классификаций и продуктов для синхронизации.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-ReportingEvent

Укажите, создает ли агент клиентский компонент Центра обновления Windows (WUA) на клиентах сообщения о событиях для отчетов WSUS. Configuration Manager не использует эти события. Не создавайте эти события, если они не требуются для других применений.

Тип:ReportingEventType
Допустимые значения:DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Schedule

Укажите объект Schedule для включения синхронизации. Чтобы отключить синхронизацию, задайте для этого параметра значение $null.

Чтобы получить объект schedule, используйте командлет New-CMSchedule .

Тип:IResultObject
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SiteCode

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

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-SynchronizeAction

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

Если выбрано значение SynchronizeFromAnUpstreamDataSourceLocation, укажите расположение источника данных с помощью параметра UpstreamSourceLocation .

Дополнительные сведения см. в разделе Планирование параметров синхронизации.

Тип:SynchronizeActionType
Допустимые значения:SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-UpstreamSourceLocation

Укажите вышестоящее расположение данных в качестве URL-адреса. Пример: https://wsusserver.contoso.com:8531

Чтобы использовать это расположение, укажите SynchronizeFromAnUpstreamDataSourceLocation для параметра SynchronizeAction .

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WaitMonth

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

Этот параметр зависит от параметра ImmediatelyExpireSupersedence .

Тип:Int32
Aliases:WaitMonthForNonFeature
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WaitMonthForFeature

Задайте целочисленное значение для количества месяцев ожидания до истечения срока действия обновления компонентов Windows после замены другого обновления.

Этот параметр зависит от параметра ImmediatelyExpireSupersedenceForFeature .

Тип:Int32
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске этого командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

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

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

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

IResultObject

Примечания

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