Set-CMClientSettingSoftwareUpdate

ソフトウェア更新プログラムのクライアント設定を構成します。

構文

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

説明

このコマンドレットを使用して、クライアント設定の [ソフトウェア更新プログラム] グループの設定を構成します。 詳細については、「クライアント設定 について:ソフトウェア更新プログラム」を参照してください

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください

例 1: 既定のクライアント設定でサード パーティの更新プログラムを有効にする

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

例 2: カスタム デバイス設定でサード パーティの更新プログラムを有効にする

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

例 3: 複数の設定を構成する

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

パラメーター

-BatchingTimeout

この時間に期限が設定された保留中のすべての展開もインストールされる期間を指定します。 このパラメーターは 、EnforceMandatory パラメーターと一緒に使用 します。 1 ~ 23 時間、および 1 ~ 365 日の値を入力できます。 既定では、この設定は 7 日間構成されています。 TimeUnit パラメーターを使用して、時間または日数を指定します。

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

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

-DefaultSetting

このパラメーターを追加して、既定のクライアント設定でソフトウェア更新プログラムの設定を構成します。

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

-DeltaDownloadPort

このパラメーターを使用して、クライアントがデルタ コンテンツの要求を受信するために使用するネットワーク ポートを構成します。 動作を 有効にするには、EnableDeltaDownload パラメーターを使用します。 既定値は 8005 です。

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

-DeploymentEvaluationSchedule

ソフトウェア更新クライアント エージェントが Configuration Manager クライアント コンピューターのインストール状態に関するソフトウェア更新プログラムを再評価する頻度を指定します。 新しいスケジュール トークンを作成するには 、New-CMSchedule コマンドレットを使用 します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない

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

-Enable

クライアントでソフトウェア更新プログラム $true を有効にするには、このパラメーターを設定します。

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

-EnableDeltaDownload

クライアントが利用可能な $true 場合にデルタ コンテンツをダウンロードするには、このパラメーターを設定します。 ネットワーク ポートを構成するには 、DeltaDownloadPort パラメーターを使用 します。

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

-EnableDynamicUpdate

バージョン 2010 以降に適用されます。 このパラメーターを設定して $true 、機能更新プログラムの動的更新Windows 10有効にします。 動的更新プログラムは、言語パック、オンデマンド機能、ドライバー、および累積的な更新プログラムをインストールWindowsします。 これらの更新プログラムをインターネットからダウンロードするクライアントに指示します。

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

-EnableInstallation

バージョン 2010 以降に適用されます。 このパラメーターを設定すると、[ソフトウェア更新プログラム] メンテナンス ウィンドウが使用可能な場合に、[すべての展開] メンテナンス ウィンドウでソフトウェア更新プログラムのインストール $true を有効にします。

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

-EnableThirdPartyUpdates

サードパーティのソフトウェア更新プログラム $true を有効にするには、このパラメーターを設定します。

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

-EnableWsusCertPinning

バージョン 2107 以降に適用されます。 このパラメーターを設定して、更新プログラムを検出するためにクライアントWindows TLS 証明書のピン留 $true めを適用します。

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

-EnforceMandatory

ソフトウェア更新プログラムの展開期限に達した場合は、指定した期間内に期限が来る他のすべてのソフトウェア更新プログラムの展開をインストールします。 BatchingTimeout パラメーターを使用して、期間を指定します。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない

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

-InputObject

このコマンドレットは、このパラメーターで指定したクライアント設定オブジェクトにソフトウェア更新設定を追加します。 このオブジェクトを取得するには 、Get-CMClientSetting コマンドレットを使用 します。

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

-Name

このコマンドレットは、このパラメーター名を持つクライアント設定オブジェクトにソフトウェア更新設定を追加します。

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

-Office365ManagementType

このパラメーターを設定 $true して、クライアント エージェントとインストールMicrosoft 365 Apps管理を有効にします。

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

-PassThru

作業しているアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

-ScanSchedule

ソフトウェア更新クライアント エージェントがコンプライアンス評価スキャンを開始する頻度を指定します。 このスキャンは、クライアント上のソフトウェア更新プログラムの状態を決定します。 新しいスケジュール トークンを作成するには 、New-CMSchedule コマンドレットを使用 します。

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

-ThreadPriority

バージョン 2010 以降に適用されます。 機能更新プログラムのスレッドWindows 10指定します。

  • Normal: Windowsセットアップでは、より多くのシステム リソースと更新プログラムを高速に使用します。 プロセッサ時間が長くなるので、合計インストール時間は短くなりますが、ユーザーの停止時間は長くなります。 この値は既定です。

  • Low: デバイスがバックグラウンドでダウンロードおよび更新されている間、引き続きデバイスで作業できます。 合計インストール時間は長くなりますが、ユーザーの停止は短くなります。 このオプションを使用する場合は、更新プログラムの最大実行時間を増やして、タイム アウトを回避する必要がある場合があります。

Type:ThreadPriorityType
Accepted values:Normal, Low
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-TimeUnit

BatchingTimeoutパラメーターと一緒に使用して、この時間内に期限が設定されている保留中のすべての展開もインストールされる期間を指定します。

Type:BatchingTimeoutType
Accepted values:Days, Hours
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object