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

次の方法で共有

Remove-CMSoftwareUpdateFromPackage

構文

説明

例

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

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

パラメーター

-Confirm

-DisableWildcardHandling

-Force

-ForceWildcardHandling

-RefreshDistributionPoint

-SoftwareUpdate

-SoftwareUpdateId

-SoftwareUpdateName

-SoftwareUpdatePackage

-SoftwareUpdatePackageId

-SoftwareUpdatePackageName

-WhatIf

入力

出力

フィードバック

その他のリソース

次の方法で共有

Remove-CMSoftwareUpdateFromPackage

構文

説明

例

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

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

パラメーター

-Confirm

-DisableWildcardHandling

-Force

-ForceWildcardHandling

-RefreshDistributionPoint

-SoftwareUpdate

-SoftwareUpdateId

-SoftwareUpdateName

-SoftwareUpdatePackage

-SoftwareUpdatePackageId

-SoftwareUpdatePackageName

-WhatIf

入力

出力

関連リンク

フィードバック

その他のリソース