Remove-CMSoftwareUpdateFromPackage

モジュール:

ConfigurationManager

ソフトウェア更新プログラム パッケージから更新プログラムを削除します。

構文

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateId <String[]>
      -SoftwareUpdatePackageId <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdate <IResultObject[]>
      -SoftwareUpdatePackageId <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdate <IResultObject[]>
      -SoftwareUpdatePackageName <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdate <IResultObject[]>
      -SoftwareUpdatePackage <IResultObject>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateId <String[]>
      -SoftwareUpdatePackageName <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateId <String[]>
      -SoftwareUpdatePackage <IResultObject>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateName <String[]>
      -SoftwareUpdatePackageId <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateName <String[]>
      -SoftwareUpdatePackageName <String>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Remove-CMSoftwareUpdateFromPackage
      -SoftwareUpdateName <String[]>
      -SoftwareUpdatePackage <IResultObject>
      [-RefreshDistributionPoint]
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドレットを使用して、指定したソフトウェア更新プログラムをパッケージから削除します。

注:

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

例

例 1: 更新プログラムを削除してコンテンツを更新する

この例では、最初にソフトウェア更新プログラムの ID を取得します。 その後、その ID でソフトウェア更新プログラム パッケージを取得します。 最後のコマンドは、パッケージから更新プログラムを削除します。 配布ポイントのコンテンツが更新され、確認を求めるメッセージは表示されません。

$SU0 = "Bing Bar 7.1 (KB2673770)"
$SU0_ID = ( Get-CMSoftwareUpdate -Name $SU0 -Fast ).CI_ID

$suppkg1 = Get-CMSoftwareUpdateDeploymentPackage -Id "XYZ0000C"

Remove-CMSoftwareUpdateFromPackage -SoftwareUpdatePackageId $suppkg1.PackageID -SoftwareUpdateId $SU0_ID -RefreshDistributionPoint -Force

例 2: 2 つの更新プログラムを削除するが、コンテンツを更新しない

この例では、最初に 2 つのソフトウェア更新プログラムの名前を定義します。 その後、その ID でソフトウェア更新プログラム パッケージを取得します。 最後のコマンドは、両方のソフトウェア更新プログラムをパッケージから削除します。 このコマンドには Force パラメーターが含まれていないため、確認を求めるメッセージが表示されます。 RefreshDistributionPoint パラメーターは含まれていないため、配布ポイントのコンテンツを手動で更新する必要があります。

$SU1 = "Bing Bar 7.1 (KB2673771)"
$SU2 = "Bing Bar 7.1 (KB2673772)"

$suppkg1 = Get-CMSoftwareUpdateDeploymentPackage -Id "XYZ0000C"

Remove-CMSoftwareUpdateFromPackage -SoftwareUpdatePackage $suppkg1 -SoftwareUpdateName ($SU1, $SU2)

パラメーター

-Confirm

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

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

-DisableWildcardHandling

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

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

-Force

確認を求めずにコマンドを実行するには、このパラメーターを追加します。

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

-ForceWildcardHandling

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

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

-RefreshDistributionPoint

配布ポイントのパッケージ コンテンツを更新するには、このパラメーターを追加します。 このパラメーターを含めない場合は、配布ポイントを手動で更新する必要があります。 詳細については、「 分散コンテンツの管理」を参照してください。

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

-SoftwareUpdate

パッケージから削除するソフトウェア更新オブジェクトの配列を指定します。 このオブジェクトを取得するには、 Get-CMSoftwareUpdate コマンドレットを使用します。

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

-SoftwareUpdateId

パッケージから削除するソフトウェア更新プログラムの ID の配列を指定します。 この値は、更新プログラムの CI_ID です (例: 1584792)。

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

-SoftwareUpdateName

パッケージから削除するソフトウェア更新プログラムの名前の配列を指定します。

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

-SoftwareUpdatePackage

更新プログラムを削除するソフトウェア更新プログラム パッケージ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMSoftwareUpdateDeploymentPackage コマンドレットを 使用します。

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

-SoftwareUpdatePackageId

更新プログラムを削除するソフトウェア更新プログラム パッケージ ID を指定します。 この値は、 XYZ0035Eなどの標準パッケージ ID です。

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

-SoftwareUpdatePackageName

更新プログラムを削除するソフトウェア更新プログラム パッケージ名を指定します。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Get-CMSoftwareUpdateDeploymentPackage
• New-CMSoftwareUpdateDeploymentPackage
• Set-CMSoftwareUpdateDeploymentPackage
• Remove-CMSoftwareUpdateDeploymentPackage
• Get-CMSoftwareUpdate
• Save-CMSoftwareUpdate