Set-CMSoftwareUpdatePointComponent

Configurare il componente del sito per il punto di aggiornamento software.

Sintassi

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

Descrizione

Usare questo cmdlet per configurare il componente del sito per il punto di aggiornamento software. Usarlo dopo aver aggiunto un punto di aggiornamento software, ad esempio con il cmdlet Add-CMSoftwareUpdatePoint . È anche possibile usare questo cmdlet per riconfigurare un punto di aggiornamento software esistente.

Un componente del punto di aggiornamento software interagisce con un server Windows Server Update Services (WSUS) per configurare le impostazioni di aggiornamento, richiedere la sincronizzazione con l'origine di aggiornamento upstream e sincronizzare gli aggiornamenti dal database WSUS al database del server del sito nel sito centrale.

Per altre informazioni, vedere Componenti del sito per Configuration Manager.

Nota

Eseguire Configuration Manager cmdlet dall'unità del sito Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1: Modificare un componente del sito del punto di aggiornamento software

Il primo comando ottiene un oggetto componente del punto di aggiornamento software dal sito XYZ . Il comando archivia l'oggetto nella variabile $supComp .

Il secondo comando crea un oggetto pianificazione da ricorrenza ogni tre giorni.

In questo esempio i parametri del cmdlet vengono quindi inseriti nella variabile parameters . Non è necessario eseguire lo splat dei parametri, ma semplifica la lettura dei parametri per una riga di comando così lunga.

L'ultimo comando modifica le proprietà comuni del componente del punto di aggiornamento 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

Esempio 2: Disabilitare la sincronizzazione del punto di aggiornamento software

Il comando seguente rimuove la pianificazione dal componente del sito, che disabilita la sincronizzazione.

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

Parametri

-AddCompany

Questo parametro è una matrice di stringhe di nomi di società. Usare questa opzione per sincronizzare l'elenco di prodotti dell'intera società.

Per rimuovere un'intera società da questo elenco, usare il parametro RemoveCompany .

Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

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

-AddLanguageSummaryDetail

Questo parametro è una matrice di stringhe di nomi di lingua. Usare questa opzione per scaricare i dettagli di riepilogo per le lingue specificate.

Per rimuovere le lingue da questo elenco, usare il parametro RemoveLanguageSummaryDetail .

Per altre informazioni, vedere Pianificare le impostazioni di sincronizzazione - Lingue.

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

-AddLanguageUpdateFile

Questo parametro è una matrice di stringhe di nomi di lingua. Usare questa opzione per scaricare il file di aggiornamento software per le lingue specificate.

Per rimuovere le lingue da questo elenco, usare il parametro RemoveLanguageUpdateFile .

Per altre informazioni, vedere Pianificare le impostazioni di sincronizzazione - Lingue.

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

-AddProduct

Questo parametro è una matrice di stringhe di nomi di prodotti. Usare questa opzione per sincronizzare i prodotti.

Per rimuovere un prodotto da questo elenco, usare il parametro RemoveProduct .

Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

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

-AddProductFamily

Questo parametro è una matrice di stringhe di nomi di famiglia di prodotti. Usare questa opzione per sincronizzare l'elenco di prodotti di una famiglia di prodotti.

Per rimuovere un'intera famiglia di prodotti da questo elenco, usare il parametro RemoveProductFamily .

Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

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

-AddUpdateClassification

Questo parametro è una matrice di stringhe di classificazioni di aggiornamento. Usare questa opzione per sincronizzare classificazioni di aggiornamenti software specifici.

Per rimuovere una classificazione da questo elenco, usare il parametro RemoveUpdateClassification .

Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-ContentFileOption

Usare questo parametro per configurare il modo in cui il punto di aggiornamento software scarica i file di aggiornamento. I file di installazione rapida offrono download più piccoli e un'installazione più rapida nei computer perché vengono scaricati e installati solo i file necessari. Sono file di dimensioni maggiori e aumenteranno i tempi di download per i server del sito e i punti di distribuzione.

  • FullFilesOnly: scaricare i file completi per tutti gli aggiornamenti approvati
  • ExpressForWindows10Only: scaricare entrambi i file completi per tutti gli aggiornamenti approvati e i file di installazione rapida per Windows 10 o versioni successive
Type:ContentFileOptions
Accepted values:FullFilesOnly, ExpressForWindows10Only
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultWsusServer

Specificare il nome di dominio completo del server WSUS.

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

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

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

-EnableCallWsusCleanupWizard

Impostare questo parametro su $true per abilitare l'esecuzione delle attività di pulizia WSUS dopo la sincronizzazione. Per altre informazioni, vedere Manutenzione degli aggiornamenti software.

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

-EnableManualCertManagement

Impostare questo parametro su $true per gestire manualmente il certificato di firma WSUS per gli aggiornamenti di terze parti. Questo parametro dipende dal parametro EnableThirdPartyUpdates .

Per altre informazioni, vedere Abilitare gli aggiornamenti di terze parti.

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

-EnableSyncFailureAlert

Impostare questo parametro su $true per consentire al componente di creare un avviso quando la sincronizzazione non riesce.

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

-EnableThirdPartyUpdates

Impostare questo parametro su $truesu Abilita aggiornamenti software di terze parti. È anche possibile usare il parametro EnableManualCertManagement .

Per altre informazioni, vedere Abilitare gli aggiornamenti di terze parti.

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

-FeatureUpdateMaxRuntimeMins

Specificare un valore intero per il tempo massimo predefinito di completamento dell'installazione di un aggiornamento software. È possibile sostituire questo valore predefinito per un aggiornamento specifico. Questa impostazione influisce solo sui nuovi aggiornamenti sincronizzati. Questo parametro si applica solo agli aggiornamenti delle funzionalità di Windows.

Per configurare il tempo di esecuzione massimo per gli aggiornamenti Office 365 e non delle funzionalità per Windows, usare il parametro NonFeatureUpdateMaxRuntimeMins.

Per altre informazioni, vedere Pianificare le impostazioni di sincronizzazione.

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

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

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

-ImmediatelyExpireSupersedence

Impostare questo parametro su per $true scadere immediatamente un aggiornamento software quando un altro aggiornamento lo sostituisce o dopo un periodo di tempo specificato.

Se si specifica un valore di $False per questo parametro, specificare il numero di mesi di attesa per la scadenza usando il parametro WaitMonth .

Alcuni aggiornamenti non scadono mai, ad esempio gli aggiornamenti delle definizioni.

Se si modifica questa impostazione, il sito avvia una sincronizzazione completa.

Per configurare questo comportamento per gli aggiornamenti delle funzionalità di Windows, usare il parametro ImmediatelyExpireSupersedenceForFeature .

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

-ImmediatelyExpireSupersedenceForFeature

Impostare questo parametro su $true per scadere immediatamente un aggiornamento delle funzionalità di Windows quando un altro aggiornamento lo sostituisce o dopo un periodo di tempo specificato.

Se si specifica un valore di $False per questo parametro, specificare il numero di mesi di attesa per la scadenza usando il parametro WaitMonthForFeature .

Se si modifica questa impostazione, il sito avvia una sincronizzazione completa.

Per configurare questo comportamento per gli aggiornamenti non delle funzionalità, usare il parametro ImmediatelyExpireSupersedence .

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

-InputObject

Specificare un oggetto componente del sito del punto di aggiornamento software da configurare. Per ottenere questo oggetto, usare il cmdlet Get-CMSoftwareUpdatePointComponent .

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

-Name

Specificare il nome di un server del sistema del sito con il ruolo del punto di aggiornamento software.

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

-NonFeatureUpdateMaxRuntimeMins

Specificare un valore intero per il tempo massimo predefinito di completamento dell'installazione di un aggiornamento software. È possibile sostituire questo valore predefinito per un aggiornamento specifico. Questa impostazione influisce solo sui nuovi aggiornamenti sincronizzati. Questo parametro si applica solo agli aggiornamenti Office 365 e non delle funzionalità per Windows.

Per configurare il tempo di esecuzione massimo per gli aggiornamenti delle funzionalità di Windows, usare il parametro FeatureUpdateMaxRuntimeMins .

Per altre informazioni, vedere Pianificare le impostazioni di sincronizzazione.

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

-PassThru

Aggiungere questo parametro per restituire un oggetto che rappresenta l'elemento con cui si sta lavorando. Per impostazione predefinita, questo cmdlet potrebbe non generare alcun output.

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

-RemoveCompany

Questo parametro è una matrice di stringhe di nomi di società. Usare questa opzione per non sincronizzare l'elenco di prodotti dell'intera società.

Per aggiungere un'intera società a questo elenco, usare il parametro AddCompany .

Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

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

-RemoveLanguageSummaryDetail

Questo parametro è una matrice di stringhe di nomi di lingua. Usare questa opzione per non scaricare i dettagli di riepilogo per le lingue specificate.

Per aggiungere lingue a questo elenco, usare il parametro AddLanguageSummaryDetail .

Per altre informazioni, vedere Pianificare le impostazioni di sincronizzazione - Lingue.

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

-RemoveLanguageUpdateFile

Questo parametro è una matrice di stringhe di nomi di lingua. Usare questa opzione per non scaricare il file di aggiornamento software per le lingue specificate.

Per aggiungere lingue a questo elenco, usare il parametro AddLanguageUpdateFile .

Per altre informazioni, vedere Pianificare le impostazioni di sincronizzazione - Lingue.

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

-RemoveProduct

Questo parametro è una matrice di stringhe di nomi di prodotti. Usare questa opzione per non sincronizzare i prodotti.

Per aggiungere un prodotto a questo elenco, usare il parametro AddProduct .

Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

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

-RemoveProductFamily

Questo parametro è una matrice di stringhe di nomi di famiglia di prodotti. Usare questa opzione per non sincronizzare l'elenco di prodotti di una famiglia di prodotti.

Per aggiungere un'intera famiglia di prodotti a questo elenco, usare il parametro AddProductFamily .

Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

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

-RemoveUpdateClassification

Questo parametro è una matrice di stringhe di classificazioni di aggiornamento. Usare questa opzione per non sincronizzare classificazioni di aggiornamenti software specifici.

Per aggiungere una classificazione a questo elenco, usare il parametro AddUpdateClassification .

Per altre informazioni, vedere Configurare classificazioni e prodotti da sincronizzare.

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

-ReportingEvent

Specificare se l'agente Windows Update nei client crea messaggi di evento per la creazione di report WSUS. Configuration Manager non usa questi eventi. Non creare questi eventi, a meno che non siano necessari per altri usi.

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

-Schedule

Specificare un oggetto Schedule per abilitare la sincronizzazione. Per disabilitare la sincronizzazione, impostare questo parametro su $null.

Per ottenere un oggetto pianificazione, usare il cmdlet New-CMSchedule .

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

-SiteCode

Specificare il codice a tre caratteri per il sito in cui configurare il componente del punto di aggiornamento software.

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

-SynchronizeAction

Specificare l'origine di sincronizzazione per questo punto di aggiornamento software.

Se si seleziona un valore di , specificare il percorso dell'origine SynchronizeFromAnUpstreamDataSourceLocationdati usando il parametro UpstreamSourceLocation .

Per altre informazioni, vedere Pianificare le impostazioni di sincronizzazione.

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

-UpstreamSourceLocation

Specificare un percorso dati upstream come URL. Ad esempio, https://wsusserver.contoso.com:8531

Per usare questo percorso, specificare SynchronizeFromAnUpstreamDataSourceLocation per il parametro SynchronizeAction .

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

-WaitMonth

Impostare il valore intero per il numero di mesi di attesa prima della scadenza di un aggiornamento software dopo che un altro aggiornamento lo sostituisce.

Questo parametro dipende dal parametro ImmediatelyExpireSupersedence .

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

-WaitMonthForFeature

Imposta il valore intero per il numero di mesi di attesa prima della scadenza di un aggiornamento delle funzionalità di Windows dopo che un altro aggiornamento lo sostituisce.

Questo parametro dipende dal parametro ImmediatelyExpireSupersedenceForFeature .

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_SCI_Component classe WMI del server.