Share via


Set-CMSoftwareUpdatePointComponent

Configure o componente do site para o ponto de atualização de software.

Syntax

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>]

Description

Use este cmdlet para configurar o componente do site para o ponto de atualização de software. Use-o depois de adicionar um ponto de atualização de software, por exemplo, com o cmdlet Add-CMSoftwareUpdatePoint . Você também pode usar esse cmdlet para reconfigurar um ponto de atualização de software existente.

Um componente de ponto de atualização de software interage com um servidor WSUS (Windows Server Update Services) para configurar configurações de atualização, solicitar sincronização com a fonte de atualização upstream e sincronizar atualizações do banco de dados WSUS para o banco de dados do servidor do site no site central.

Para obter mais informações, consulte Componentes do site para Configuration Manager.

Observação

Execute Configuration Manager cmdlets da unidade do site Configuration Manager, por exemplo PS XYZ:\>. Para obter mais informações, confira introdução.

Exemplos

Exemplo 1: modificar um componente do site de ponto de atualização de software

O primeiro comando obtém um objeto de componente de ponto de atualização de software do site XYZ . O comando armazena o objeto na variável $supComp .

O segundo comando cria um objeto de agendamento para repetir a cada três dias.

Este exemplo, em seguida , splats os parâmetros cmdlet na variável parâmetros . Não é necessário emendar os parâmetros, apenas facilita a leitura dos parâmetros para uma linha de comando tão longa.

O último comando modifica propriedades comuns do componente do ponto de atualização de software.

$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

Exemplo 2: Desabilitar a sincronização de ponto de atualização de software

O comando a seguir remove o agendamento do componente do site, o que desabilita a sincronização.

Set-CMSoftwareUpdatePointComponent -Name "Contoso-SiteSysSrv.Western.Contoso.com" -Schedule $null

Parâmetros

-AddCompany

Esse parâmetro é uma matriz de cadeia de caracteres de nomes da empresa. Use essa opção para sincronizar a lista de produtos de toda a empresa.

Para remover uma empresa inteira desta lista, use o parâmetro RemoveCompany .

Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

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

-AddLanguageSummaryDetail

Esse parâmetro é uma matriz de cadeia de caracteres de nomes de idioma. Use essa opção para baixar detalhes de resumo para os idiomas especificados.

Para remover idiomas desta lista, use o parâmetro RemoveLanguageSummaryDetail .

Para obter mais informações, consulte Planejar configurações de sincronização – Idiomas.

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

-AddLanguageUpdateFile

Esse parâmetro é uma matriz de cadeia de caracteres de nomes de idioma. Use essa opção para baixar o arquivo de atualização de software para os idiomas especificados.

Para remover idiomas desta lista, use o parâmetro RemoveLanguageUpdateFile .

Para obter mais informações, consulte Planejar configurações de sincronização – Idiomas.

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

-AddProduct

Esse parâmetro é uma matriz de cadeia de caracteres de nomes de produto. Use essa opção para sincronizar Produtos.

Para remover um produto desta lista, use o parâmetro RemoveProduct .

Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

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

-AddProductFamily

Esse parâmetro é uma matriz de cadeia de caracteres de nomes de família de produtos. Use essa opção para sincronizar a lista de Produtos de uma família de produtos.

Para remover toda uma família de produtos desta lista, use o parâmetro RemoveProductFamily .

Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

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

-AddUpdateClassification

Esse parâmetro é uma matriz de cadeia de caracteres de classificações de atualização. Use essa opção para sincronizar classificações de atualização de software específicas.

Para remover uma classificação desta lista, use o parâmetro RemoveUpdateClassification .

Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContentFileOption

Use esse parâmetro para configurar como o ponto de atualização de software baixa arquivos de atualização. Os arquivos de instalação expressos fornecem menor download e instalação mais rápida em computadores porque apenas os arquivos necessários são baixados e instalados. Eles são arquivos maiores e aumentarão o tempo de download para os servidores do site e os pontos de distribuição.

  • FullFilesOnly: baixe arquivos completos para todas as atualizações aprovadas
  • ExpressForWindows10Only: baixe os arquivos completos para todas as atualizações aprovadas e arquivos de instalação expressos para Windows 10 ou posterior
Type:ContentFileOptions
Accepted values:FullFilesOnly, ExpressForWindows10Only
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultWsusServer

Especifique o FQDN do servidor WSUS.

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

-DisableWildcardHandling

Esse parâmetro trata caracteres curinga como valores de caractere literal. Você não pode combiná-lo com ForceWildcardHandling.

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

-EnableCallWsusCleanupWizard

Defina esse parâmetro para $true habilitar tarefas de limpeza do WSUS a serem executadas após a sincronização. Para obter mais informações, consulte Manutenção de atualizações de software.

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

-EnableManualCertManagement

Defina esse parâmetro para $true gerenciar manualmente o certificado de assinatura do WSUS para atualizações de terceiros. Esse parâmetro depende do parâmetro EnableThirdPartyUpdates .

Para obter mais informações, consulte Habilitar atualizações de terceiros.

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

-EnableSyncFailureAlert

Defina esse parâmetro para $true permitir que o componente crie um alerta quando a sincronização falhar.

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

-EnableThirdPartyUpdates

Defina esse parâmetro como $trueHabilitar atualizações de software de terceiros. Você também pode usar o parâmetro EnableManualCertManagement .

Para obter mais informações, consulte Habilitar atualizações de terceiros.

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

-FeatureUpdateMaxRuntimeMins

Especifique um valor inteiro para o tempo máximo padrão que uma instalação de atualização de software precisa ser concluída. Você pode substituir esse padrão para uma atualização específica. Essa configuração afeta apenas atualizações recém-sincronizadas. Esse parâmetro só se aplica às atualizações de recursos do Windows.

Para configurar o tempo máximo de execução para atualizações Office 365 e não recursos para Windows, use o parâmetro NonFeatureUpdateMaxRuntimeMins.

Para obter mais informações, consulte Planejar configurações de sincronização.

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

-ForceWildcardHandling

Esse parâmetro processa caracteres curinga e pode levar a um comportamento inesperado (não recomendado). Você não pode combiná-lo com DisableWildcardHandling.

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

-ImmediatelyExpireSupersedence

Defina esse parâmetro para $true expirar imediatamente uma atualização de software quando outra atualização o substituir ou após um período de tempo especificado.

Se você especificar um valor desse $False parâmetro, especifique o número de meses para aguardar a expiração usando o parâmetro WaitMonth .

Algumas atualizações nunca expiram, por exemplo, atualizações de definição.

Se você alterar essa configuração, o site iniciará uma sincronização completa.

Para configurar esse comportamento para atualizações de recursos do Windows, use o parâmetro ImmediatelyExpireSupersedenceForFeature .

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

-ImmediatelyExpireSupersedenceForFeature

Defina esse parâmetro para $true expirar imediatamente uma atualização de recurso do Windows quando outra atualização o substituir ou após um período de tempo especificado.

Se você especificar um valor desse $False parâmetro, especifique o número de meses para aguardar a expiração usando o parâmetro WaitMonthForFeature .

Se você alterar essa configuração, o site iniciará uma sincronização completa.

Para configurar esse comportamento para atualizações não-recurso, use o parâmetro ImmediatelyExpireSupersedence .

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

-InputObject

Especifique um objeto de componente do site de ponto de atualização de software a ser configurado. Para obter esse objeto, use o cmdlet Get-CMSoftwareUpdatePointComponent .

Type:IResultObject
Aliases:Site, SiteComponent
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifique o nome de um servidor do sistema de site com a função de ponto de atualização de software.

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

-NonFeatureUpdateMaxRuntimeMins

Especifique um valor inteiro para o tempo máximo padrão que uma instalação de atualização de software precisa ser concluída. Você pode substituir esse padrão para uma atualização específica. Essa configuração afeta apenas atualizações recém-sincronizadas. Esse parâmetro só se aplica a atualizações de Office 365 e não de recursos para Windows.

Para configurar o tempo máximo de execução para atualizações de recursos do Windows, use o parâmetro FeatureUpdateMaxRuntimeMins .

Para obter mais informações, consulte Planejar configurações de sincronização.

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

-PassThru

Adicione esse parâmetro para retornar um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet pode não gerar nenhuma saída.

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

-RemoveCompany

Esse parâmetro é uma matriz de cadeia de caracteres de nomes da empresa. Use essa opção para não sincronizar a lista de produtos de toda a empresa.

Para adicionar uma empresa inteira a essa lista, use o parâmetro AddCompany .

Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

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

-RemoveLanguageSummaryDetail

Esse parâmetro é uma matriz de cadeia de caracteres de nomes de idioma. Use essa opção para não baixar detalhes de resumo para os idiomas especificados.

Para adicionar idiomas a essa lista, use o parâmetro AddLanguageSummaryDetail .

Para obter mais informações, consulte Planejar configurações de sincronização – Idiomas.

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

-RemoveLanguageUpdateFile

Esse parâmetro é uma matriz de cadeia de caracteres de nomes de idioma. Use essa opção para não baixar o arquivo de atualização de software para os idiomas especificados.

Para adicionar idiomas a essa lista, use o parâmetro AddLanguageUpdateFile .

Para obter mais informações, consulte Planejar configurações de sincronização – Idiomas.

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

-RemoveProduct

Esse parâmetro é uma matriz de cadeia de caracteres de nomes de produto. Use essa opção para não sincronizar Produtos.

Para adicionar um produto a essa lista, use o parâmetro AddProduct .

Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

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

-RemoveProductFamily

Esse parâmetro é uma matriz de cadeia de caracteres de nomes de família de produtos. Use essa opção para não sincronizar a lista de Produtos de uma família de produtos.

Para adicionar uma família de produtos inteira a essa lista, use o parâmetro AddProductFamily .

Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

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

-RemoveUpdateClassification

Esse parâmetro é uma matriz de cadeia de caracteres de classificações de atualização. Use essa opção para não sincronizar classificações de atualização de software específicas.

Para adicionar uma classificação a essa lista, use o parâmetro AddUpdateClassification .

Para obter mais informações, consulte Configurar classificações e produtos para sincronizar.

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

-ReportingEvent

Especifique se o WUA (Agente Windows Update) nos clientes cria mensagens de evento para relatórios WSUS. Configuration Manager não usa esses eventos. Não crie esses eventos, a menos que você exija deles para outros usos.

Type:ReportingEventType
Accepted values:DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

Especifique um objeto Agendar para habilitar a sincronização. Para desabilitar a sincronização, defina esse parâmetro como $null.

Para obter um objeto de agendamento, use o cmdlet New-CMSchedule .

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

-SiteCode

Especifique o código de três caracteres para o site no qual configurar seu componente de ponto de atualização de software.

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

-SynchronizeAction

Especifique a fonte de sincronização para este ponto de atualização de software.

Se você selecionar um valor de , especifique o local da SynchronizeFromAnUpstreamDataSourceLocationfonte de dados usando o parâmetro UpstreamSourceLocation .

Para obter mais informações, consulte Planejar configurações de sincronização.

Type:SynchronizeActionType
Accepted values:SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UpstreamSourceLocation

Especifique um local de dados upstream como uma URL. Por exemplo, https://wsusserver.contoso.com:8531

Para usar esse local, especifique SynchronizeFromAnUpstreamDataSourceLocation para o parâmetro SynchronizeAction .

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

-WaitMonth

Defina o valor inteiro para o número de meses a aguardar antes que uma atualização de software expire depois que outra atualização o substitui.

Esse parâmetro depende do parâmetro ImmediatelyExpireSupersedence .

Type:Int32
Aliases:WaitMonthForNonFeature
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WaitMonthForFeature

Defina o valor inteiro para o número de meses a aguardar antes que uma atualização de recurso do Windows expire depois que outra atualização o substitui.

Esse parâmetro depende do parâmetro ImmediatelyExpireSupersedenceForFeature .

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

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Saídas

IResultObject

Observações

Para obter mais informações sobre esse objeto retornado e suas propriedades, consulte SMS_SCI_Component classe WMI do servidor.