次の方法で共有


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

注:

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

例 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 パラメーターを使用します。

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

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

-AddLanguageSummaryDetail

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

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

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

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

-AddLanguageUpdateFile

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

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

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

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

-AddProduct

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

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

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

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

-AddProductFamily

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

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

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

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

-AddUpdateClassification

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

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

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

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

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultWsusServer

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

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

-DisableWildcardHandling

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

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

-EnableCallWsusCleanupWizard

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

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

-EnableManualCertManagement

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

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

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

-EnableSyncFailureAlert

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

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

-EnableThirdPartyUpdates

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

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

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

-FeatureUpdateMaxRuntimeMins

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

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

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

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

-ForceWildcardHandling

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

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

-ImmediatelyExpireSupersedence

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

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

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

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

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

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

-ImmediatelyExpireSupersedenceForFeature

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

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

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

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

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

-InputObject

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

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

-Name

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

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

-NonFeatureUpdateMaxRuntimeMins

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

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

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

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

-PassThru

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

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

-RemoveCompany

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

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

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

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

-RemoveLanguageSummaryDetail

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

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

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

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

-RemoveLanguageUpdateFile

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

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

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

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

-RemoveProduct

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

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

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

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

-RemoveProductFamily

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

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

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

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

-RemoveUpdateClassification

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

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

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

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

-ReportingEvent

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

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

-Schedule

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

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

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

-SiteCode

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

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

-SynchronizeAction

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

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

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

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

-UpstreamSourceLocation

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

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

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

-WaitMonth

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

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

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

-WaitMonthForFeature

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

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

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

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