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

説明

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

注意

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

例

例 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

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

Type:	SwitchParameter
Aliases:	cf
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

-Force

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

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

-RefreshDistributionPoint

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

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

-SoftwareUpdate

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

Type:	IResultObject[]
Aliases:	SoftwareUpdates
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SoftwareUpdateId

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

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

-SoftwareUpdateName

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

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

-SoftwareUpdatePackage

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

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

-SoftwareUpdatePackageId

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

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

-SoftwareUpdatePackageName

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

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

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