Uninstall-Package

模組:

PackageManagement Module

卸載一或多個軟體套件。

語法

PackageByInputObject

Uninstall-Package
    [-InputObject] <SoftwareIdentity[]>
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

PackageBySearch

Uninstall-Package
    [-Name] <String[]>
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ProviderName <String[]>]
    [<CommonParameters>]

NuGet:PackageByInputObject

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

NuGet:PackageBySearch

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Destination <String>]
    [-ExcludeVersion]
    [-Scope <String>]
    [-SkipDependencies]
    [<CommonParameters>]

PowerShellGet:PackageByInputObject

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Scope <String>]
    [-PackageManagementProvider <String>]
    [-Type <String>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-InstallUpdate]
    [-NoPathUpdate]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

PowerShellGet:PackageBySearch

Uninstall-Package
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-Scope <String>]
    [-PackageManagementProvider <String>]
    [-Type <String>]
    [-AllowClobber]
    [-SkipPublisherCheck]
    [-InstallUpdate]
    [-NoPathUpdate]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Description

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

這很重要

PackageManagement 模組中包含的命令與 Visual Studio 套件管理員控制台中 NuGet 模組所提供的命令不同。 每個模組都有其他模組中無法使用的命令。 具有相同名稱的命令會在其特定自變數中有所不同。 如需詳細資訊，請參閱Visual Studio套件管理員主控台的 PowerShell參考 檔。

範例

範例 1：卸載套件

Uninstall-Package Cmdlet 會卸載套件。 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
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AllowPrereleaseVersions

允許卸載標示為發行前版本的套件。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-AllVersions

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

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Confirm

在執行 Cmdlet 之前，提示您進行確認。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	cf

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Destination

指定輸入物件路徑的字串。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NuGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

NuGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ExcludeVersion

切換以排除資料夾路徑中的版本號碼。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NuGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

NuGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Force

強制命令執行，而不要求使用者確認。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ForceBootstrap

強制 PackageManagement 自動安裝指定套件的套件提供者。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InputObject

接受管線輸入，指定來自 Cmdlet 的套件 Get-Package 物件。 InputObject 接受 SoftwareIdentity 物件做為 Get-Package 值或包含 物件的變數。

參數屬性

類型:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PackageByInputObject

Position:	0
必要:	True
來自管線的值:	True
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-InstallUpdate

表示 Uninstall-Package 卸載更新。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MaximumVersion

指定您要卸載的最大允許套件版本。 如果未指定此參數，Uninstall-Package 卸載套件的最新版本。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-MinimumVersion

指定您想要卸載的最低允許套件版本。 如果您未新增此參數，Uninstall-Package 會卸載符合 MaximumVersion 參數所指定之任何版本的套件最新版本。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Name

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

參數屬性

類型:	String[]
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PackageBySearch

Position:	0
必要:	True
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-NoPathUpdate

NoPathUpdate 僅適用於 Install-Script Cmdlet。 NoPathUpdate 是由提供者新增的動態參數， Uninstall-Package不支援 。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-PackageManagementProvider

指定 PackageManagement 提供者。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-ProviderName

指定要搜尋套件的一或多個套件提供者名稱。 您可以執行 Get-PackageProvider Cmdlet 來取得套件提供者名稱。

參數屬性

類型:	String[]
預設值:	None
接受的值:	Bootstrap, NuGet, PowerShellGet
支援萬用字元:	False
不要顯示:	False
別名:	供應商

參數集

PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	True
來自剩餘引數的值:	False

-RequiredVersion

指定您想要卸載之套件的確切允許版本。 如果您未新增此參數，Uninstall-Package 會卸載符合 MaximumVersion 參數所指定之任何版本的套件最新版本。

參數屬性

類型:	String
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Scope

指定要卸載封裝的範圍。 此參數可接受的值如下：

• 目前使用者
• 所有使用者

參數屬性

類型:	String
預設值:	None
接受的值:	CurrentUser, AllUsers
支援萬用字元:	False
不要顯示:	False

參數集

NuGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

NuGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SkipDependencies

略過軟體相依性的卸載。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

NuGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

NuGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-SkipPublisherCheck

可讓您取得比已安裝版本還新的套件版本。 例如，由信任的發行者以數位方式簽署的已安裝套件，但未以數位方式簽署新版本。

參數屬性

類型:	SwitchParameter
預設值:	None
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-Type

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

• 模組
• 劇本
• 全部

參數屬性

類型:	String
預設值:	None
接受的值:	Module, Script, All
支援萬用字元:	False
不要顯示:	False

參數集

PowerShellGet:PackageByInputObject

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

PowerShellGet:PackageBySearch

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

-WhatIf

顯示執行 Uninstall-Package Cmdlet 時會發生什麼情況。 該 Cmdlet 未被執行。

參數屬性

類型:	SwitchParameter
預設值:	False
支援萬用字元:	False
不要顯示:	False
別名:	無線

參數集

(All)

Position:	Named
必要:	False
來自管線的值:	False
來自管線按屬性名稱的值:	False
來自剩餘引數的值:	False

CommonParameters

此 Cmdlet 支援一般參數：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。

輸入

Microsoft.PackageManagement.Packaging.SoftwareIdentity

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

輸出

Microsoft.PackageManagement.Packaging.SoftwareIdentity

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

備註

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

相關連結

• 關於_PackageManagement
• Find-Package
• Get-Package
• Install-Package
• Save-Package