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 aprovadasExpressForWindows10Only
: 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 $true
Habilitar 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 SynchronizeFromAnUpstreamDataSourceLocation
fonte 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.
Links Relacionados
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de