Uninstall-Module
モジュールをアンインストールします。
構文
Uninstall-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-RequiredVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-AllowPrerelease]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Uninstall-Module
[-InputObject] <PSObject[]>
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
コマンドレットは Uninstall-Module
、指定したモジュールをローカル コンピューターからアンインストールします。 他のモジュールが依存している場合、またはモジュールが コマンドレットと共にインストールされていない場合は、モジュールを Install-Module
アンインストールできません。
モジュール ファイルは手動で削除できますが、削除されたモジュールに依存するすべてのモジュールが壊れる可能性があります。
モジュールのバージョン番号を受け取るパラメーターでは、バージョン番号として書式設定された文字列が必要です。
- 標準バージョン番号の形式
x.y.z
は x、y、z は数値です - プレリリースバージョンには、 がそのリリースに割り当てられた任意の
x.y.z-<prerelease_label>
<prerelease_label>
文字列である という形式があります。
例
例 1: モジュールをアンインストールする
この例では、モジュールをアンインストールします。
Uninstall-Module -Name SpeculationControl
Uninstall-Module
では、 Name パラメーターを使用して、ローカル コンピューターからアンインストールするモジュールを指定します。
例 2: パイプラインを使用してモジュールをアンインストールする
この例では、パイプラインを使用してモジュールをアンインストールします。
Get-InstalledModule -Name SpeculationControl | Uninstall-Module
Get-InstalledModule
では、 Name パラメーターを使用してモジュールを指定します。 オブジェクトはパイプラインから に Uninstall-Module
送信され、アンインストールされます。
パラメーター
-AllowPrerelease
プレリリースとしてマークされたモジュールをアンインストールできます。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllVersions
モジュールの使用可能なすべてのバージョンを含める必要があることを指定します。 MinimumVersion、MaximumVersion、または RequiredVersion パラメーターで AllVersions パラメーターを使用することはできません。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
を実行する前に確認を求めるメッセージが表示されます Uninstall-Module
。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Uninstall-Module
ユーザーの確認を求めずに強制的に実行します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
PSRepositoryItemInfo オブジェクトを受け入れます。 たとえば、変数に出力 Get-InstalledModule
し、その変数を InputObject 引数として使用します。
Type: | PSObject[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MaximumVersion
アンインストールするモジュールの最大バージョン (最新) を指定します。 MaximumVersion パラメーターと RequiredVersion パラメーターは、同じコマンドでは使用できません。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MinimumVersion
アンインストールするモジュールの最小バージョンを指定します。 MinimumVersion パラメーターと RequiredVersion パラメーターは、同じコマンドでは使用できません。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
アンインストールするモジュール名の配列を指定します。
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RequiredVersion
アンインストールするモジュールの正確なバージョン番号を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
が実行された場合 Uninstall-Module
の動作を示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
String[]
PSObject[]
出力
関連リンク
PowerShellGet