Freigeben über


Set-CMClientSettingSoftwareUpdate

Konfigurieren Sie Clienteinstellungen für Softwareupdates.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um Einstellungen in der Gruppe Softwareupdates der Clienteinstellungen zu konfigurieren. Weitere Informationen finden Sie unter Informationen zu Clienteinstellungen: Softwareupdates.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Aktivieren von Updates von Drittanbietern in den Standardclienteinstellungen

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

Beispiel 2: Aktivieren von Drittanbieterupdates in einer benutzerdefinierten Geräteeinstellung

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

Beispiel 3: Konfigurieren mehrerer Einstellungen

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

Parameter

-BatchingTimeout

Geben Sie den Zeitraum an, für den alle ausstehenden Bereitstellungen mit einem Stichtag in diesem Zeitraum ebenfalls installiert werden sollen. Verwenden Sie diesen Parameter mit dem EnforceMandatory-Parameter . Sie können einen Wert zwischen 1 und 23 Stunden und von 1 bis 365 Tagen eingeben. Standardmäßig ist diese Einstellung für sieben Tage konfiguriert. Verwenden Sie den TimeUnit-Parameter , um Stunden oder Tage anzugeben.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultSetting

Fügen Sie diesen Parameter hinzu, um Softwareupdateeinstellungen in den Standardclienteinstellungen zu konfigurieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeltaDownloadPort

Verwenden Sie diesen Parameter, um den Netzwerkport zu konfigurieren, den Clients zum Empfangen von Anforderungen für Deltainhalte verwenden. Verwenden Sie den Parameter EnableDeltaDownload , um das Verhalten zu aktivieren. Der Standardwert ist 8005.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DeploymentEvaluationSchedule

Geben Sie an, wie oft der Softwareupdate-Client-Agent Softwareupdates für den Installationsstatus auf Configuration Manager-Clientcomputern neu auswertet. Verwenden Sie zum Erstellen eines neuen Zeitplantokens das Cmdlet New-CMSchedule .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Enable

Legen Sie diesen Parameter auf fest $true , um Softwareupdates auf Clients zu aktivieren.

Typ:Boolean
Aliase:EnableSoftwareUpdatesOnClient
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableDeltaDownload

Legen Sie diesen Parameter auf fest $true , damit Clients Deltainhalte herunterladen können, sofern verfügbar. Verwenden Sie zum Konfigurieren des Netzwerkports den DeltaDownloadPort-Parameter .

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableDynamicUpdate

Gilt für Version 2010 und höher. Legen Sie diesen Parameter auf fest $true , um dynamische Updates für Windows 10-Featureupdates zu aktivieren. Dynamisches Update installiert Sprachpakete, Features bei Bedarf, Treiber und kumulative Updates während des Windows-Setups. Es weist den Client an, diese Updates aus dem Internet herunterzuladen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableInstallation

Gilt für Version 2010 und höher. Legen Sie diesen Parameter auf fest, um die Installation von Softwareupdates im Wartungsfenster "Alle Bereitstellungen" zu $true aktivieren, wenn das Wartungsfenster "Softwareupdate" verfügbar ist.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableThirdPartyUpdates

Legen Sie diesen Parameter auf fest $true , um Softwareupdates von Drittanbietern zu aktivieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnableWsusCertPinning

Gilt für Version 2107 und höher. Legen Sie diesen Parameter auf fest $true , um das Anheften von TLS-Zertifikaten für den Windows Update-Client zum Erkennen von Updates zu erzwingen.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-EnforceMandatory

Wenn der Stichtag für die Bereitstellung von Softwareupdates erreicht ist, installieren Sie alle anderen Softwareupdatebereitstellungen, deren Stichtag innerhalb eines bestimmten Zeitraums liegt. Verwenden Sie den Parameter BatchingTimeout , um den Zeitraum anzugeben.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Dieses Cmdlet fügt die Softwareupdateeinstellungen dem Clienteinstellungsobjekt hinzu, das Sie mit diesem Parameter angeben. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMClientSetting .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Dieses Cmdlet fügt die Softwareupdateeinstellungen dem Clienteinstellungsobjekt hinzu, das dieser Parameter benennt.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Office365ManagementType

Legen Sie diesen Parameter auf fest $true , um die Verwaltung des Microsoft 365 Apps-Client-Agents und der Installationseinstellungen zu aktivieren.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScanSchedule

Geben Sie an, wie oft der Client-Agent für Softwareupdates eine Konformitätsbewertungsüberprüfung startet. Dieser Scan bestimmt den Status von Softwareupdates auf dem Client. Verwenden Sie zum Erstellen eines neuen Zeitplantokens das Cmdlet New-CMSchedule .

Typ:IResultObject
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ThreadPriority

Gilt für Version 2010 und höher. Geben Sie eine Threadpriorität für Windows 10-Featureupdates an.

  • Normal: Windows Setup verwendet schneller mehr Systemressourcen und Updates. Es wird mehr Prozessorzeit benötigt, sodass die Gesamtinstallationszeit kürzer ist, aber der Ausfall des Benutzers länger ist. Dieser Wert ist die Standardeinstellung.

  • Low: Sie können weiterhin auf dem Gerät arbeiten, während es im Hintergrund heruntergeladen und aktualisiert wird. Die Gesamtinstallationszeit ist länger, der Ausfall des Benutzers ist jedoch kürzer. Möglicherweise müssen Sie die maximale Updatelaufzeit erhöhen, um ein Timeout zu vermeiden, wenn Sie diese Option verwenden.

Typ:ThreadPriorityType
Zulässige Werte:Normal, Low
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-TimeUnit

Verwenden Sie mit dem BatchingTimeout-Parameter , um den Zeitraum anzugeben, für den alle ausstehenden Bereitstellungen mit einem Stichtag in diesem Zeitraum ebenfalls installiert werden.

Typ:BatchingTimeoutType
Zulässige Werte:Days, Hours
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object