Uninstall-Package

模組:

PackageManagement

卸載一或多個軟體套件。

Syntax

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>]

Description

Cmdlet Uninstall-Package 會從本機電腦卸載一或多個軟體套件。 若要尋找已安裝的套件，請使用 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

Cmdlet 會 Get-Package 使用 Name 和 RequiredVersion 參數來指定封裝。 SoftwareIdentity物件會在管線下傳送。 Cmdlet Uninstall-Package 會以 InputObject 的形式接收物件，並移除封裝。

或者， Uninstall-Package Cmdlet 可以指定 InputObject 參數的值：

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

表示此 Cmdlet 會卸載套件的所有版本。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

在執行 Cmdlet 前提示您確認。

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

接受管線輸入，指定 Cmdlet 中 Get-Package 封裝的SoftwareIdentity物件。 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-Package 請將符合 MaximumVersion 參數指定之任何版本的套件最新版本卸載。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

指定一或多個封裝名稱。 多個封裝名稱必須以逗號分隔。

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoPathUpdate

NoPathUpdate 僅適用于 Install-Script Cmdlet。 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

指定要搜尋套件的一或多個套件提供者名稱。 您可以執行 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-Package 請將符合 MaximumVersion 參數指定之任何版本的套件最新版本卸載。

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

指定是否要搜尋具有模組、腳本或兩者的套件。 此參數可接受的值如下所示：

• 模組
• 指令碼
• 全部

Type:	String
Accepted values:	Module, Script, All
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

顯示執行 Cmdlet 時 Uninstall-Package 會發生什麼情況。 不會執行此 Cmdlet。

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

輸入

Microsoft.PackageManagement.Packaging.SoftwareIdentity

您可以使用管線 將 SoftwareIdentity 物件傳送至此 Cmdlet。

輸出

Microsoft.PackageManagement.Packaging.SoftwareIdentity

此 Cmdlet 會針對卸載的每個套件傳回 SoftwareIdentity 物件。

備註

在命令中包含套件提供者，可讓 Cmdlet 使用動態參數。 動態參數專屬於封裝提供者。 Cmdlet Get-Help 會列出 Cmdlet 的參數集，並包含提供者的參數集。 例如， Uninstall-Package 具有包含 -NoPathUpdate 、 AllowClobber 和 SkipPublisherCheck 的PowerShellGet參數集。

相關連結

• about_PackageManagement
• Find-Package
• Get-Package
• Install-Package
• Save-Package