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-ScriptNoPathUpdate はプロバイダーによって追加される動的パラメーターであり、 では 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