Condividi tramite

Set-CMClientSettingSoftwareUpdate

  • Riferimento
Modulo:
ConfigurationManager

Configurare le impostazioni client per gli aggiornamenti software.

Sintassi

Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   -Name <String>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   [-DefaultSetting]
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMClientSettingSoftwareUpdate
   [-BatchingTimeout <Int32>]
   [-DeltaDownloadPort <Int32>]
   [-DeploymentEvaluationSchedule <IResultObject>]
   [-Enable <Boolean>]
   [-EnableDeltaDownload <Boolean>]
   [-EnableDynamicUpdate <Boolean>]
   [-EnableInstallation <Boolean>]
   [-EnableThirdPartyUpdates <Boolean>]
   [-EnableWsusCertPinning <Boolean>]
   [-EnforceMandatory <Boolean>]
   [-Office365ManagementType <Boolean>]
   [-ScanSchedule <IResultObject>]
   [-ThreadPriority <ThreadPriorityType>]
   [-TimeUnit <BatchingTimeoutType>]
   -InputObject <IResultObject>
   [-PassThru]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per configurare le impostazioni nel gruppo Aggiornamenti software delle impostazioni client. Per altre informazioni, vedere Informazioni sulle impostazioni client: aggiornamenti software.

Nota

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

Esempio

Esempio 1: Abilitare gli aggiornamenti di terze parti nelle impostazioni client predefinite

Set-CMClientSettingSoftwareUpdate -DefaultSetting -Enable $true -EnableThirdPartyUpdates $true

Esempio 2: Abilitare gli aggiornamenti di terze parti in un'impostazione personalizzata del dispositivo

$clientDeviceSettingName = "Dev device settings"
Set-CMClientSettingSoftwareUpdate -Name $clientDeviceSettingName -Enable $true -EnableThirdPartyUpdates $true

Esempio 3: Configurare più impostazioni

Set-CMClientSettingSoftwareUpdate -InputObject $testsetting -Enable $true -ScanSchedule $Sch1 -DeploymentEvaluationSchedule $Sch2 -BatchingTimeout 3 -TimeUnit Days -EnforceMandatory $true -Office365ManagementType $false -EnableThirdPartyUpdates $true -EnableDeltaDownload $true -EnableInstallation $true -ThreadPriority Normal -EnableDynamicUpdate $true

Parametri

-BatchingTimeout

Specificare il periodo di tempo per il quale verranno installate anche tutte le distribuzioni in sospeso con scadenza in questo periodo. Usare questo parametro con il parametro EnforceMandatory . È possibile immettere un valore compreso tra 1 e 23 ore e da 1 a 365 giorni. Per impostazione predefinita, questa impostazione viene configurata per sette giorni. Usare il parametro TimeUnit per specificare ore o giorni.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultSetting

Aggiungere questo parametro per configurare le impostazioni di aggiornamento software nelle impostazioni client predefinite.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeltaDownloadPort

Usare questo parametro per configurare la porta di rete usata dai client per ricevere richieste di contenuto delta. Usare il parametro EnableDeltaDownload per abilitare il comportamento. Il valore predefinito è 8005.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DeploymentEvaluationSchedule

Specificare la frequenza con cui l'agente client aggiorna il software rivaluta gli aggiornamenti software per lo stato di installazione nei computer client di Configuration Manager. Per creare un nuovo token di pianificazione, usare il cmdlet New-CMSchedule .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Enable

Impostare questo parametro su $true per abilitare gli aggiornamenti software nei client.

Tipo:Boolean
Alias:EnableSoftwareUpdatesOnClient
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableDeltaDownload

Impostare questo parametro su $true per consentire ai client di scaricare contenuto differenziale quando disponibile. Per configurare la porta di rete, usare il parametro DeltaDownloadPort .

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableDynamicUpdate

Si applica alla versione 2010 e successive. Impostare questo parametro su $true per abilitare l'aggiornamento dinamico per gli aggiornamenti delle funzionalità di Windows 10. L'aggiornamento dinamico installa Language Pack, funzionalità su richiesta, driver e aggiornamenti cumulativi durante l'installazione di Windows. Indica al client di scaricare questi aggiornamenti da Internet.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableInstallation

Si applica alla versione 2010 e successive. Impostare questo parametro su $true per abilitare l'installazione degli aggiornamenti software nella finestra di manutenzione "Tutte le distribuzioni" quando è disponibile la finestra di manutenzione "Aggiornamento software".

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableThirdPartyUpdates

Impostare questo parametro su $true per abilitare gli aggiornamenti software di terze parti.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnableWsusCertPinning

Si applica alla versione 2107 e successive. Impostare questo parametro su $true per applicare l'aggiunta di certificati TLS per il client Windows Update per il rilevamento degli aggiornamenti.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-EnforceMandatory

Quando viene raggiunta una scadenza per la distribuzione degli aggiornamenti software, installare tutte le altre distribuzioni di aggiornamenti software con scadenza entro un periodo di tempo specificato. Utilizzare il parametro BatchingTimeout per specificare il periodo di tempo.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InputObject

Questo cmdlet aggiunge le impostazioni di aggiornamento software all'oggetto impostazioni client specificato con questo parametro. Per ottenere questo oggetto, usare il cmdlet Get-CMClientSetting .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Questo cmdlet aggiunge le impostazioni di aggiornamento software all'oggetto impostazioni client che questo parametro chiama.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Office365ManagementType

Impostare questo parametro su $true per abilitare la gestione dell'agente client e delle impostazioni di installazione di Microsoft 365 Apps.

Tipo:Boolean
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-PassThru

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ScanSchedule

Specificare la frequenza con cui l'agente client di aggiornamenti software avvia un'analisi di valutazione della conformità. Questa analisi determina lo stato per gli aggiornamenti software nel client. Per creare un nuovo token di pianificazione, usare il cmdlet New-CMSchedule .

Tipo:IResultObject
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ThreadPriority

Si applica alla versione 2010 e successive. Specificare una priorità del thread per gli aggiornamenti delle funzionalità di Windows 10.

  • Normal: il programma di installazione di Windows usa più risorse di sistema e aggiornamenti più velocemente. Usa più tempo processore, quindi il tempo totale di installazione è più breve, ma l'interruzione dell'utente è più lunga. Questo valore è il valore predefinito.

  • Low: è possibile continuare a lavorare sul dispositivo durante il download e gli aggiornamenti in background. Il tempo totale di installazione è più lungo, ma l'interruzione dell'utente è più breve. Potrebbe essere necessario aumentare il tempo di esecuzione massimo dell'aggiornamento per evitare un timeout quando si usa questa opzione.

Tipo:ThreadPriorityType
Valori accettati:Normal, Low
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-TimeUnit

Utilizzare con il parametro BatchingTimeout per specificare il periodo di tempo per il quale verranno installate anche tutte le distribuzioni in sospeso con una scadenza in questo periodo.

Tipo:BatchingTimeoutType
Valori accettati:Days, Hours
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Output

System.Object