Remove-CMDeployment
デプロイを削除します。
構文
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 では、既にインストールされているアプリケーションのインスタンスは削除されません。 これらのアプリケーションを削除するには、[アンインストール] アクションを使用してアプリケーションをコンピューターに展開する必要があります。 アプリケーションの展開を削除するか、デプロイするコレクションからリソースを削除すると、アプリケーションはソフトウェア センターに表示されなくなります。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 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
デプロイに関連付けられているアプリケーションの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CollectionName
デプロイに関連付けられているコレクションの名前を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeploymentId
デプロイの ID を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | 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 |
-InputObject
デプロイ オブジェクトを指定します。 デプロイ オブジェクトを取得するには、Get-CMDeployment コマンドレットを使用します。
| 型: | IResultObject |
| Aliases: | Deployment |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | False |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object