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>] 説明
クライアント設定の [ソフトウェア更新プログラム ] グループで設定を構成するには、このコマンドレットを使用します。 詳細については、「 クライアント設定について: ソフトウェアの更新プログラム」を参照してください。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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 パラメーターを使用して、時間または日を指定します。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DefaultSetting
このパラメーターを追加して、既定のクライアント設定でソフトウェア更新プログラムの設定を構成します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeltaDownloadPort
このパラメーターを使用して、クライアントがデルタ コンテンツの要求を受信するために使用するネットワーク ポートを構成します。
EnableDeltaDownload パラメーターを使用して、動作を有効にします。 既定値は 8005 です。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeploymentEvaluationSchedule
ソフトウェア更新プログラム クライアント エージェントが、Configuration Manager クライアント コンピューターのインストール状態のソフトウェア更新プログラムを再評価する頻度を指定します。 新しいスケジュール トークンを作成するには、 New-CMSchedule コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Enable
クライアントでソフトウェア更新プログラムを有効にするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| Aliases: | EnableSoftwareUpdatesOnClient |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableDeltaDownload
このパラメーターを $true に設定して、クライアントが利用可能な場合に差分コンテンツをダウンロードできるようにします。 ネットワーク ポートを構成するには、 DeltaDownloadPort パラメーターを使用します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableDynamicUpdate
バージョン 2010 以降に適用されます。 Windows 10 機能更新プログラムの動的更新を有効にするには、このパラメーターを $true に設定します。 動的更新プログラムは、Windows セットアップ中に言語パック、オンデマンド機能、ドライバー、および累積的な更新プログラムをインストールします。 これらの更新プログラムをインターネットからダウンロードするようにクライアントに指示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableInstallation
バージョン 2010 以降に適用されます。 このパラメーターを $true に設定して、"ソフトウェア更新プログラム" メンテナンス期間が利用可能な場合に [すべての展開] メンテナンス期間でソフトウェア更新プログラムのインストールを有効にします。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableThirdPartyUpdates
サード パーティ製ソフトウェア更新プログラムを有効にするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnableWsusCertPinning
バージョン 2107 以降に適用されます。 更新プログラムを検出するために Windows Update クライアントに TLS 証明書のピン留めを適用するには、このパラメーターを $true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnforceMandatory
ソフトウェア更新プログラムの展開期限に達したら、指定した期間内に期限が到来する他のすべてのソフトウェア更新プログラムの展開をインストールします。 BatchingTimeout パラメーターを使用して、期間を指定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
このコマンドレットは、このパラメーターで指定したクライアント設定オブジェクトにソフトウェア更新設定を追加します。 このオブジェクトを取得するには、 Get-CMClientSetting コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Name
このコマンドレットは、このパラメーター名を持つクライアント設定オブジェクトにソフトウェア更新設定を追加します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Office365ManagementType
Microsoft 365 Apps クライアント エージェントとインストール設定の管理を有効にするには、このパラメーターを $true に設定します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PassThru
作業中のアイテムを表す オブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ScanSchedule
ソフトウェア更新クライアント エージェントがコンプライアンス評価スキャンを開始する頻度を指定します。 このスキャンは、クライアント上のソフトウェア更新プログラムの状態を決定します。 新しいスケジュール トークンを作成するには、 New-CMSchedule コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ThreadPriority
バージョン 2010 以降に適用されます。 Windows 10 機能更新プログラムのスレッド優先度を指定します。
Normal: Windows セットアップでは、より多くのシステム リソースと更新プログラムが高速に使用されます。 より多くのプロセッサ時間を使用するため、合計インストール時間は短くなりますが、ユーザーの停止は長くなります。 この値が既定値です。Low: バックグラウンドでデバイスをダウンロードして更新しながら、引き続きデバイスで作業できます。 合計インストール時間は長くなりますが、ユーザーの停止は短くなります。 このオプションを使用する場合は、タイムアウトを回避するために、更新プログラムの最大実行時間を増やす必要がある場合があります。
| 型: | ThreadPriorityType |
| 指定可能な値: | Normal, Low |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TimeUnit
BatchingTimeout パラメーターと共にを使用して、期限が設定されているすべての保留中のデプロイもインストールされる期間を指定します。
| 型: | BatchingTimeoutType |
| 指定可能な値: | Days, Hours |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object