Uninstall-Package
1 つ以上のソフトウェア パッケージをアンインストールします。
構文
Uninstall-Package
[-InputObject] <SoftwareIdentity[]>
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Uninstall-Package
[-Name] <String[]>
[-RequiredVersion <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-ProviderName <String[]>]
[<CommonParameters>]
Uninstall-Package
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]
Uninstall-Package
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-Destination <String>]
[-ExcludeVersion]
[-Scope <String>]
[-SkipDependencies]
[<CommonParameters>]
Uninstall-Package
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-Type <String>]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[-AllowPrereleaseVersions]
[<CommonParameters>]
Uninstall-Package
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-Type <String>]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[-AllowPrereleaseVersions]
[<CommonParameters>]
説明
コマンドレットは Uninstall-Package 、ローカル コンピューターから 1 つ以上のソフトウェア パッケージをアンインストールします。 インストールされているパッケージを検索するには、コマンドレットを Get-Package 使用します。
例
例 1: パッケージをアンインストールする
コマンドレットは Uninstall-Package パッケージをアンインストールします。 Name パラメーターは、アンインストールするパッケージを指定します。 パッケージの複数のバージョンがインストールされている場合は、最新バージョンがアンインストールされます。
PS> Uninstall-Package -Name NuGet.Core
例 2: パイプラインを使用してパッケージをアンインストールする
Get-Package は特定のパッケージを検索し、 SoftwareIdentity オブジェクトをパイプラインの下のコマンドレットに Uninstall-Package 送信します。
PS> Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 | Uninstall-Package
このコマンドレットではGet-Package、Name パラメーターと RequiredVersion パラメーターを使用してパッケージを指定します。
SoftwareIdentity オブジェクトがパイプラインの下に送信されます。 コマンドレットは Uninstall-Package 、 InputObject としてオブジェクトを受け取り、パッケージを削除します。
別の方法として、コマンドレットは Uninstall-PackageInputObject パラメーターの値を指定できます。
Uninstall-Package -InputObject ( Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 )
パラメーター
既存のコマンドとの競合に関する警告メッセージをオーバーライドします。 インストールされているコマンドと同じ名前の既存のコマンドを上書きします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
プレリリースとしてマークされたパッケージのアンインストールを許可します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
このコマンドレットがパッケージのすべてのバージョンをアンインストールすることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットの実行前に確認を求めるメッセージが表示されます。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力オブジェクトへのパスの文字列を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
フォルダー パスのバージョン番号を除外するように切り替えます。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ユーザーに確認せずに、直ちにコマンドを実行します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
指定したパッケージのパッケージ プロバイダーを自動的にインストールするように PackageManagement を強制します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットからパッケージの SoftwareIdentity オブジェクトを指定するパイプライン入力を Get-Package 受け入れます。 InputObject は、 SoftwareIdentity オブジェクトを値またはオブジェクトを Get-Package 含む変数として受け入れます。
| Type: | Microsoft.PackageManagement.Packaging.SoftwareIdentity[] |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
更新プログラムをアンインストールすることを Uninstall-Package 示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
アンインストールする最大許容パッケージ バージョンを指定します。 このパラメーターを指定しない場合は、 Uninstall-Package パッケージの最新バージョンをアンインストールします。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
アンインストールする最小許容パッケージ バージョンを指定します。 このパラメーターを追加しない場合は、 Uninstall-PackageMaximumVersion パラメーターで指定されたバージョンを満たすパッケージの最新バージョンをアンインストールします。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
1 つ以上のパッケージ名を指定します。 複数のパッケージ名はコンマで区切る必要があります。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
NoPathUpdate は コマンドレットにのみ適用されます Install-Script 。 NoPathUpdate は、プロバイダーによって追加される動的パラメーターであり、サポートされていません Uninstall-Package。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
PackageManagement プロバイダーを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
パッケージを検索する 1 つ以上のパッケージ プロバイダー名を指定します。 Get-PackageProvider コマンドレットを実行して、パッケージ プロバイダー名を取得できます。
| Type: | String[] |
| Aliases: | Provider |
| Accepted values: | Bootstrap, NuGet, PowerShellGet |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
アンインストールするパッケージの許可されている正確なバージョンを指定します。 このパラメーターを追加しない場合は、 Uninstall-PackageMaximumVersion パラメーターで指定されたバージョンを満たすパッケージの最新バージョンをアンインストールします。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
パッケージをアンインストールするスコープを指定します。 このパラメーターに使用できる値は次のとおりです。
- CurrentUser
- AllUsers
| Type: | String |
| Accepted values: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
ソフトウェアの依存関係のアンインストールをスキップします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
インストールされているバージョンよりも新しいパッケージ バージョンを取得できます。 たとえば、信頼できる発行元によってデジタル署名されているが、新しいバージョンがデジタル署名されていないインストール済みパッケージなどです。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
モジュール、スクリプト、またはその両方を使用してパッケージを検索するかどうかを指定します。 このパラメーターに使用できる値は次のとおりです。
- Module
- スクリプト
- すべて
| Type: | String |
| Accepted values: | Module, Script, All |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
コマンドレットが実行された場合 Uninstall-Package の動作を示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
SoftwareIdentity
Uninstall-Package は、パイプラインから SoftwareIdentity オブジェクトを入力として受け入れます。
出力
SoftwareIdentity
Uninstall-Package は、アンインストールされた各パッケージの SoftwareIdentity オブジェクトを返します。
メモ
コマンドにパッケージ プロバイダーを含めると、コマンドレットで動的パラメーターを使用できるようになります。 動的パラメーターは、パッケージ プロバイダーに固有です。 コマンドレットには Get-Help 、コマンドレットのパラメーター セットが一覧表示され、プロバイダーのパラメーター セットが含まれます。 たとえば、 Uninstall-PackagePowerShellGet パラメーター セットには、、および 〘 AllowClobberを含む-NoPathUpdate値が設定されていますSkipPublisherCheck。