Set-CMSoftwareUpdatePointComponent

ソフトウェアの更新ポイントのサイト コンポーネントを構成します。

構文

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

説明

このコマンドレットを使用して、ソフトウェアの更新ポイントのサイト コンポーネントを構成します。 ソフトウェアの更新ポイントを追加した後 、たとえば Add-CMSoftwareUpdatePoint コマンドレットで使用します。 このコマンドレットを使用して、既存のソフトウェアの更新ポイントを再構成することもできます。

ソフトウェア更新ポイント コンポーネントは、Windows Server Update Services (WSUS) サーバーと対話して、更新設定の構成、アップストリームの更新ソースへの同期の要求、WSUS データベースから中央サイト上のサイト サーバー データベースへの更新プログラムの同期を行います。

詳細については、「 Configuration Manager のサイト コンポーネント」を参照してください。

注:

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

例 1: ソフトウェアの更新ポイント サイト コンポーネントを変更する

最初のコマンドは、 XYZ サイトからソフトウェア更新ポイント コンポーネント オブジェクトを取得します。 コマンドは、 オブジェクトを $supComp 変数に格納します。

2 番目のコマンドは、3 日ごとに繰り返す schedule オブジェクトを作成します。

次の使用例は、コマンドレット パラメーターを parameters 変数にスプラットします。 パラメーターをスプラッタする必要はありません。これにより、このような長いコマンド ラインのパラメーターを読みやすくなります。

最後のコマンドは、ソフトウェア更新ポイント コンポーネントの一般的なプロパティを変更します。

$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

例 2: ソフトウェアの更新ポイントの同期を無効にする

次のコマンドは、同期を無効にするサイト コンポーネントからスケジュールを削除します。

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

パラメーター

-AddCompany

このパラメーターは、会社名の文字列配列です。 このオプションを使用して、会社の製品の一覧全体を同期 します

このリストから会社全体を削除するには、 RemoveCompany パラメーターを使用します。

詳細については、「 同期する分類と製品を構成する」を参照してください。

型:String[]
Aliases:AddCompanies
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AddLanguageSummaryDetail

このパラメーターは、言語名の文字列配列です。 指定した言語の 概要の詳細 をダウンロードするには、このオプションを使用します。

この一覧から言語を削除するには、 RemoveLanguageSummaryDetail パラメーターを使用します。

詳細については、「 同期設定の計画 - 言語」を参照してください。

型:String[]
Aliases:AddLanguageSummaryDetails
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AddLanguageUpdateFile

このパラメーターは、言語名の文字列配列です。 指定した言語の ソフトウェア更新プログラム ファイル をダウンロードするには、このオプションを使用します。

この一覧から言語を削除するには、 RemoveLanguageUpdateFile パラメーターを使用します。

詳細については、「 同期設定の計画 - 言語」を参照してください。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AddProduct

このパラメーターは、製品名の文字列配列です。 製品を同期するには、このオプションを使用 します

このリストから製品を削除するには、 RemoveProduct パラメーターを使用します。

詳細については、「 同期する分類と製品を構成する」を参照してください。

型:String[]
Aliases:AddProducts
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AddProductFamily

このパラメーターは、製品ファミリ名の文字列配列です。 製品ファミリの製品リストを同期するには、このオプションを使用 します

このリストから製品ファミリ全体を削除するには、 RemoveProductFamily パラメーターを使用します。

詳細については、「 同期する分類と製品を構成する」を参照してください。

型:String[]
Aliases:AddProductFamilies
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AddUpdateClassification

このパラメーターは、更新の分類の文字列配列です。 特定のソフトウェア更新プログラム の分類を同期するには、このオプションを使用します。

このリストから分類を削除するには、 RemoveUpdateClassification パラメーターを使用します。

詳細については、「 同期する分類と製品を構成する」を参照してください。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ContentFileOption

このパラメーターを使用して、ソフトウェアの更新ポイントが更新ファイルをダウンロードする方法を構成します。 高速インストール ファイルでは、ダウンロードが小さくなり、必要なファイルのみがダウンロードされてインストールされるため、コンピューターへのインストールが高速化されます。 ファイルが大きく、サイト サーバーと配布ポイントのダウンロード時間が長くなります。

  • FullFilesOnly: 承認されたすべての更新プログラムの完全なファイルをダウンロードする
  • ExpressForWindows10Only: Windows 10 以降のすべての承認済み更新プログラムと高速インストール ファイルの両方の完全なファイルをダウンロードします
型:ContentFileOptions
指定可能な値:FullFilesOnly, ExpressForWindows10Only
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultWsusServer

WSUS サーバーの FQDN を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableCallWsusCleanupWizard

同期後に WSUS クリーンアップ タスクを実行できるようにするには、このパラメーターを $true に設定します。 詳細については、「 ソフトウェア更新プログラムのメンテナンス」を参照してください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableManualCertManagement

サード パーティの更新プログラムの WSUS 署名証明書を手動で管理するには、このパラメーターを $true に設定します。 このパラメーターは 、EnableThirdPartyUpdates パラメーターに依存します

詳細については、「 サード パーティの更新プログラムを有効にする」を参照してください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableSyncFailureAlert

同期が失敗したときにコンポーネントがアラートを作成できるようにするには、このパラメーターを $true に設定します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-EnableThirdPartyUpdates

このパラメーターを $true に設定して 、サード パーティ製ソフトウェア更新プログラムを有効にしますEnableManualCertManagement パラメーターを使用することもできます。

詳細については、「 サード パーティの更新プログラムを有効にする」を参照してください。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-FeatureUpdateMaxRuntimeMins

ソフトウェア更新プログラムのインストールが完了する必要がある既定の最大時間の整数値を指定します。 この既定値は、特定の更新プログラムに対してオーバーライドできます。 この設定は、新しく同期された更新プログラムにのみ影響します。 このパラメーターは、Windows 機能の更新プログラムにのみ適用されます。

Windows の Office 365 更新プログラムと機能以外の更新プログラムの最大実行時間を構成するには、 NonFeatureUpdateMaxRuntimeMins パラメーターを使用します。

詳細については、「 同期設定の計画」を参照してください。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ImmediatelyExpireSupersedence

このパラメーターを $true に設定すると、別の更新プログラムが置き換えられたり、指定した期間が経過した後にソフトウェア更新プログラムがすぐに期限切れになります。

このパラメーターに $False の値を指定する場合は、 WaitMonth パラメーターを使用して、有効期限を待機する月数を指定します。

定義の更新など、一部の更新プログラムの有効期限は切れません。

この設定を変更すると、サイトは完全同期を開始します。

Windows 機能更新プログラムのこの動作を構成するには、 ImmediatelyExpireSupersedenceForFeature パラメーターを使用します。

型:Boolean
Aliases:ImmediatelyExpireSupersedenceForNonFeature
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ImmediatelyExpireSupersedenceForFeature

このパラメーターを $true に設定すると、別の更新プログラムが置き換えられたり、指定した期間が経過した後に Windows 機能更新プログラムがすぐに期限切れになります。

このパラメーターに $False の値を指定する場合は、 WaitMonthForFeature パラメーターを使用して、有効期限を待機する月数を指定します。

この設定を変更すると、サイトは完全同期を開始します。

機能以外の更新プログラムに対してこの動作を構成するには、 ImmediatelyExpireSupersedence パラメーターを使用します。

型:Boolean
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

構成するソフトウェア更新ポイント サイト コンポーネント オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSoftwareUpdatePointComponent コマンドレットを 使用します。

型:IResultObject
Aliases:Site, SiteComponent
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

ソフトウェアの更新ポイントの役割を持つサイト システム サーバーの名前を指定します。

型:String
Aliases:SiteName
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-NonFeatureUpdateMaxRuntimeMins

ソフトウェア更新プログラムのインストールが完了する必要がある既定の最大時間の整数値を指定します。 この既定値は、特定の更新プログラムに対してオーバーライドできます。 この設定は、新しく同期された更新プログラムにのみ影響します。 このパラメーターは、Windows の Office 365 更新プログラムと機能以外の更新プログラムにのみ適用されます。

Windows 機能更新プログラムの最大実行時間を構成するには、 FeatureUpdateMaxRuntimeMins パラメーターを 使用します。

詳細については、「 同期設定の計画」を参照してください。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-PassThru

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveCompany

このパラメーターは、会社名の文字列配列です。 会社の製品の一覧全体を同期 しない 場合は、このオプションを使用 します

この一覧に会社全体を追加するには、 AddCompany パラメーターを使用します。

詳細については、「 同期する分類と製品を構成する」を参照してください。

型:String[]
Aliases:RemoveCompanies
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveLanguageSummaryDetail

このパラメーターは、言語名の文字列配列です。 指定した言語の概要の詳細をダウンロードしない場合は、このオプションを使用します。

この一覧に言語を追加するには、 AddLanguageSummaryDetail パラメーターを使用します。

詳細については、「 同期設定の計画 - 言語」を参照してください。

型:String[]
Aliases:RemoveLanguageSummaryDetails
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveLanguageUpdateFile

このパラメーターは、言語名の文字列配列です。 指定した言語のソフトウェア更新プログラム ファイルをダウンロードしない場合は、このオプションを使用します。

この一覧に言語を追加するには、 AddLanguageUpdateFile パラメーターを使用します。

詳細については、「 同期設定の計画 - 言語」を参照してください。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveProduct

このパラメーターは、製品名の文字列配列です。 製品を同期 しない 場合は、このオプションを使用 します

このリストに製品を追加するには、 AddProduct パラメーターを使用します。

詳細については、「 同期する分類と製品を構成する」を参照してください。

型:String[]
Aliases:RemoveProducts
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveProductFamily

このパラメーターは、製品ファミリ名の文字列配列です。 製品ファミリの製品リストを同期 しない 場合は、このオプションを使用 します

このリストに製品ファミリ全体を追加するには、 AddProductFamily パラメーターを使用します。

詳細については、「 同期する分類と製品を構成する」を参照してください。

型:String[]
Aliases:RemoveProductFamilies
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RemoveUpdateClassification

このパラメーターは、更新の分類の文字列配列です。 特定のソフトウェア更新プログラムの分類を同期しない場合は、このオプションを使用します。

このリストに分類を追加するには、 AddUpdateClassification パラメーターを使用します。

詳細については、「 同期する分類と製品を構成する」を参照してください。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ReportingEvent

クライアントの Windows Update エージェント (WUA) が WSUS レポート用のイベント メッセージを作成するかどうかを指定します。 Configuration Manager では、これらのイベントは使用されません。 他の用途に必要な場合を除き、これらのイベントを作成しないでください。

型:ReportingEventType
指定可能な値:DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Schedule

同期を有効にする Schedule オブジェクトを指定します。 同期を無効にするには、このパラメーターを $null に設定します。

schedule オブジェクトを取得するには、 New-CMSchedule コマンドレットを 使用します。

型:IResultObject
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SiteCode

ソフトウェアの更新ポイント コンポーネントを構成するサイトの 3 文字のコードを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SynchronizeAction

このソフトウェアの更新ポイントの同期ソースを指定します。

SynchronizeFromAnUpstreamDataSourceLocationの値を選択する場合は、UpstreamSourceLocation パラメーターを使用してデータ ソースの場所を指定します。

詳細については、「 同期設定の計画」を参照してください。

型:SynchronizeActionType
指定可能な値:SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-UpstreamSourceLocation

アップストリーム データの場所を URL として指定します。 たとえば、https://wsusserver.contoso.com:8531 のように指定します。

この場所を使用するには、SynchronizeAction パラメーターにSynchronizeFromAnUpstreamDataSourceLocationを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WaitMonth

別の更新プログラムが置き換えられた後、ソフトウェア更新プログラムの有効期限が切れるまで待機する月数の整数値を設定します。

このパラメーターは、 ImmediatelyExpireSupersedence パラメーターによって 異なります。

型:Int32
Aliases:WaitMonthForNonFeature
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WaitMonthForFeature

別の更新プログラムが置き換えられた後、Windows 機能更新プログラムの有効期限が切れるまで待機する月数の整数値を設定します。

このパラメーターは、 ImmediatelyExpireSupersedenceForFeature パラメーターによって異なります。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_SCI_Component」を参照してください。