Uninstall-Package

参考

模块:: PackageManagement

卸载一个或多个软件包。

语法

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 cmdlet 从本地计算机卸载一个或多个软件包。若要查找已安装的包，请使用 Get-Package cmdlet。

重要

PackageManagement 模块中包含的命令不同于 Visual Studio 的包管理器控制台中 NuGet 模块提供的命令。每个模块都有在其他模块中不可用的命令。具有相同名称的命令在其特定参数中有所不同。有关详细信息，请参阅 Visual Studio 的包管理器控制台的 PowerShell 参考文档。

示例

示例 1：卸载包

cmdlet Uninstall-Package 卸载包。 Name 参数指定要卸载的包。如果安装了包的多个版本，则会卸载最新版本。

PS> Uninstall-Package -Name NuGet.Core

示例 2：使用管道卸载包

Get-Package 找到特定的包，并将 SoftwareIdentity 对象向下 Uninstall-Package 发送到 cmdlet。

PS> Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 | Uninstall-Package

该 Get-Package cmdlet 使用 Name 和 RequiredVersion 参数来指定包。 SoftwareIdentity 对象将发送到管道。该 Uninstall-Package cmdlet 接收对象作为 InputObject 并删除包。

或者， Uninstall-Package cmdlet 可以为 InputObject 参数指定值：

Uninstall-Package -InputObject ( Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 )

参数

-AllowClobber

重写有关与现有命令冲突的警告消息。覆盖与所安装的命令同名的现有命令。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AllowPrereleaseVersions

允许卸载标记为预发行版的包。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AllVersions

指示此 cmdlet 卸载包的所有版本。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

-Destination

指定输入对象路径的字符串。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ExcludeVersion

切换到排除文件夹路径中的版本号。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Force

强制命令运行而不要求用户确认。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ForceBootstrap

强制 PackageManagement 为指定的包自动安装包提供程序。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-InputObject

接受管道输入，该输入指定 cmdlet 中的包 的 SoftwareIdentity 对象 Get-Package 。 InputObject 接受 SoftwareIdentity 对象作为值 Get-Package 或包含该对象的变量。

类型:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	True
接受通配符:	False

-InstallUpdate

指示 Uninstall-Package 卸载更新。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MaximumVersion

指定要卸载的最大允许包版本。如果未指定此参数， Uninstall-Package 请卸载包的最新版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MinimumVersion

指定要卸载的最小允许包版本。如果未添加此参数， Uninstall-Package 请卸载包的最新版本，该版本满足 MaximumVersion 参数指定的任何版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定一个或多个包名称。多个包名称必须用逗号分隔。

类型:	String[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NoPathUpdate

NoPathUpdate 仅适用于 Install-Script cmdlet。 NoPathUpdate 是由提供程序添加的动态参数，不受提供程序支持 Uninstall-Package。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PackageManagementProvider

指定 PackageManagement 提供程序。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProviderName

指定要搜索包的一个或多个包提供程序名称。可以通过运行 Get-PackageProvider cmdlet 来获取包提供程序名称。

类型:	String[]
别名:	Provider
接受的值:	Bootstrap, NuGet, PowerShellGet
Position:	Named
默认值:	None
必需:	False
接受管道输入:	True
接受通配符:	False

-RequiredVersion

指定要卸载的包的确切允许版本。如果未添加此参数， Uninstall-Package 请卸载包的最新版本，该版本满足 MaximumVersion 参数指定的任何版本。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Scope

指定要卸载包的范围。此参数的可接受值如下所示：

当前用户
AllUsers

类型:	String
接受的值:	CurrentUser, AllUsers
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkipDependencies

跳过软件依赖项的卸载。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkipPublisherCheck

允许获取比已安装版本更新的包版本。例如，由受信任的发布者数字签名但新版本未进行数字签名的已安装包。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Type

指定是使用模块、脚本还是同时搜索包。此参数的可接受值如下所示：

模块
脚本
全部

类型:	String
接受的值:	Module, Script, All
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示运行 cmdlet 会发生什么 Uninstall-Package 情况。 cmdlet 未能运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	False
必需:	False
接受管道输入:	False
接受通配符:	False

输入

Microsoft.PackageManagement.Packaging.SoftwareIdentity

可以通过管道将 SoftwareIdentity 对象传递给此 cmdlet。

输出