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 サイト ドライブからConfiguration Managerコマンドレットを実行します (例: PS XYZ:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 1: アプリケーションのデプロイを削除する

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

このコマンドは、CMappD01 という名前のアプリケーションに関連付けられ、All Users という名前のコレクションに適用される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
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-CollectionName

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

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

-Confirm

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

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

-DeploymentId

デプロイの ID を指定します。

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

-DisableWildcardHandling

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

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

-Force

確認メッセージなしでアクションを実行します。

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

-ForceWildcardHandling

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

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

-InputObject

デプロイ オブジェクトを指定します。 デプロイ オブジェクトを取得するには、Get-CMDeployment コマンドレットを使用します。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• Get-CMDeployment
• Get-CMDeploymentType
• Remove-CMDeploymentType