Remove-CMProgram
パッケージからプログラムを削除します。
構文
Remove-CMProgram
[-Force]
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Remove-CMProgram
[-Force]
-PackageId <String>
-ProgramName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
このコマンドレットを使用して、パッケージからプログラムを削除します。 パッケージからプログラムを削除すると、Configuration Manager は、このプログラムのすべての展開を削除します。 Configuration Manager が既にクライアントで展開されたプログラムを実行している場合、Configuration Manager はソフトウェアを削除しません。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 名前と ID を使用してプログラムを削除する
このコマンドは、ID XYZ0000Fを持つパッケージから ProgramD02 という名前のプログラムを削除します。
Remove-CMProgram -PackageId "XYZ0000F" -ProgramName "ProgramD02"
例 2: オブジェクト変数を使用してプログラムを削除する
最初のコマンドでは、Get-CMProgram コマンドレットを使用して、ID XYZ0000Fを持つパッケージ内の ProgramD02 という名前のプログラムを取得します。 結果は $Prog 変数に格納されます。
2 番目のコマンドは、プログラムを削除します。
$Prog = Get-CMProgram -Name "ProgramD02" -PackageId "XYZ0000F"
Remove-CMProgram -InputObject $Prog -Force
パラメーター
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | 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 |
-InputObject
削除するプログラム オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMProgram コマンドレットを 使用します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-PackageId
削除するプログラムを含むパッケージの ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ProgramName
削除するプログラムを含むパッケージの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | True |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object