Remove-CMDeployment

  • リファレンス
モジュール:
ConfigurationManager

展開を削除します。

構文

Remove-CMDeployment
      [-Force]
      -InputObject <IResultObject>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeployment
      -ApplicationName <String>
      -DeploymentId <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMDeployment
      -ApplicationName <String>
      -CollectionName <String>
      [-Force]
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-CMDeployment コマンドレットは、Configuration Manager からアプリケーションの展開を削除します。

アプリケーションの展開を削除しても、既にインストールされているアプリケーションのインスタンスは削除されません。 これらのアプリケーションを削除するには、[アンインストール] アクションを実行してアプリケーションをコンピューターに展開する必要があります。 アプリケーション展開を削除するか、展開するコレクションからリソースを削除すると、アプリケーションはソフトウェア センターに表示されなくなりました。

注意

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

例

例 1: アプリケーションの展開を削除する

PS XYZ:\> Remove-CMDeployment -ApplicationName "CMappD01" -CollectionName "All Users"

このコマンドは、CMappD01 という名前のアプリケーションに関連付けられた Configuration Manager 展開を削除し、すべてのユーザーという名前のコレクションに適用されます。

例 2: 展開オブジェクトを渡して削除する

PS XYZ:\> Get-CMDeployment -CollectionName "deviceCol01" -FeatureType Application | Remove-CMDeployment -Force

このコマンドは、deiceCol01 という名前のコレクションの指定されたアプリケーション展開オブジェクトを取得し、パイプライン 演算子を使用してオブジェクトを Remove-CMDeploymentに渡し、展開を削除します。 Force パラメーターを 指定 すると、展開が削除される前にユーザーにメッセージが表示されません。

例 3: ID で展開を削除する

PS XYZ:\> Remove-CMDeployment -DeploymentId "{890082B6-7C16-4600-8807-7E0003BC9D99}" -ApplicationName "application01" -Force

このコマンドは、指定された ID を持つ application01 という名前の展開を削除します。 Force パラメーターを 指定 すると、展開が削除される前にユーザーにメッセージが表示されません。

パラメーター

-ApplicationName

展開に関連付けられているアプリケーションの名前を指定します。

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

展開に関連付けられているコレクションの名前を指定します。

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

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

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

展開の ID を指定します。

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

展開オブジェクトを指定します。 展開オブジェクトを取得するには、次のコマンドレットGet-CMDeploymentします。

Type:IResultObject
Aliases:Deployment
Position:Named
Default value:None
Accept pipeline input:True
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

出力

System.Object