Set-CMSoftwareUpdatePointComponent

モジュール:

ConfigurationManager

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

構文

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 のサイト コンポーネント」を参照してください。

注意

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

例

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

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

2 番目のコマンドは、3 日ごとに再び実行するスケジュール オブジェクトを作成します。

次の使用 例は、コマンドレット パラメーターを 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 パラメーターを使用 します。

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

Type:	String[]
Aliases:	AddCompanies
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddLanguageSummaryDetail

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

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

詳細については、「Plan for synchronization settings - Languages 」を参照してください。

Type:	String[]
Aliases:	AddLanguageSummaryDetails
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddLanguageUpdateFile

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

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

詳細については、「Plan for synchronization settings - Languages 」を参照してください。

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

-AddProduct

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

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

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

Type:	String[]
Aliases:	AddProducts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddProductFamily

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

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

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

Type:	String[]
Aliases:	AddProductFamilies
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AddUpdateClassification

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

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

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

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

-Confirm

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

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

-ContentFileOption

このパラメーターを使用して、ソフトウェアの更新ポイントが更新ファイルをダウンロードする方法を構成します。 高速インストール ファイルは、必要なファイルだけがダウンロードおよびインストールされるので、コンピューターへのダウンロードが小さくて高速なインストールを提供します。 これらのファイルはサイズが大きく、サイト サーバーと配布ポイントのダウンロード時間が増加します。

• FullFilesOnly: すべての承認済み更新プログラムの完全なファイルをダウンロードする
• ExpressForWindows10Only: すべての承認済み更新プログラム用の完全なファイルと、すべての更新プログラム用の高速インストール ファイルの両方Windows 10ダウンロードします。

Type:	ContentFileOptions
Accepted values:	FullFilesOnly, ExpressForWindows10Only
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultWsusServer

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

Type:	String
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

-EnableCallWsusCleanupWizard

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

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

-EnableManualCertManagement

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

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

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

-EnableSyncFailureAlert

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

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

-EnableThirdPartyUpdates

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

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

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

-FeatureUpdateMaxRuntimeMins

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

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

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

Type:	Int32
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

-ImmediatelyExpireSupersedence

別の更新プログラムがソフトウェア更新プログラムに取ってかえり、または指定した期間が経過した後に、ソフトウェア更新プログラムが直ちに期限切れになる場合に、このパラメーター $true を設定します。

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

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

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

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

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

-ImmediatelyExpireSupersedenceForFeature

このパラメーターを、別の更新プログラムがWindows、または指定した期間が経過した後に、新しい機能更新プログラムの有効期限が直ちに切れる $true に設定します。

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

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

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

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

-InputObject

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

Type:	IResultObject
Aliases:	Site, SiteComponent
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

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

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

-NonFeatureUpdateMaxRuntimeMins

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

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

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

Type:	Int32
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

-RemoveCompany

このパラメーターは、会社名の文字列配列です。 このオプションを使用して 、会社 の製品のリスト全体を同期 させる必要はありません。

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

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

Type:	String[]
Aliases:	RemoveCompanies
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveLanguageSummaryDetail

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

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

詳細については、「Plan for synchronization settings - Languages 」を参照してください。

Type:	String[]
Aliases:	RemoveLanguageSummaryDetails
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveLanguageUpdateFile

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

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

詳細については、「Plan for synchronization settings - Languages 」を参照してください。

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

-RemoveProduct

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

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

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

Type:	String[]
Aliases:	RemoveProducts
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveProductFamily

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

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

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

Type:	String[]
Aliases:	RemoveProductFamilies
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-RemoveUpdateClassification

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

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

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

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

-ReportingEvent

クライアントの更新エージェント (WUA) Windows WSUS レポートのイベント メッセージを作成するかどうかを指定します。 Configuration Manager は、これらのイベントを使用しない。 これらのイベントは、他の用途で必要としない限り、作成しません。

Type:	ReportingEventType
Accepted values:	DoNotCreateWsusReportingEvents, CreateOnlyWsusStatusReportingEvents, CreateAllWsusReportingEvents
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Schedule

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

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

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

-SiteCode

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

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

-SynchronizeAction

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

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

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

Type:	SynchronizeActionType
Accepted values:	SynchronizeFromMicrosoftUpdate, SynchronizeFromAnUpstreamDataSourceLocation, DoNotSynchronizeFromMicrosoftUpdateOrUpstreamDataSource
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UpstreamSourceLocation

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

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

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

-WaitMonth

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

このパラメーターは 、ImmediatelyExpireSupersedence パラメーターに依存 します。

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

-WaitMonthForFeature

別の更新プログラムが期限切れになる前に、Windowsの整数値を設定します。

このパラメーターは 、ImmediatelyExpireSupersedenceForFeature パラメーターに依存 します。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

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

関連リンク

• Get-CMSoftwareUpdatePointComponent
• Add-CMSoftwareUpdatePoint
• Configuration Manager のサイト コンポーネント