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