Uninstall-Package

Modul:

PackageManagement Module

Odinstaluje jeden nebo více softwarových balíčků.

Syntaxe

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

Rutina Uninstall-Package odinstaluje jeden nebo více softwarových balíčků z místního počítače. K vyhledání nainstalovaných balíčků použijte rutinu Get-Package.

Důležité

Příkazy obsažené v modulu PackageManagement se liší od příkazů poskytovaných modulem NuGet v konzole Správce balíčků sady Visual Studio. Každý modul obsahuje příkazy, které nejsou k dispozici v druhém modulu. Příkazy se stejným názvem se liší v jejich konkrétních argumentech. Další informace najdete v referenční dokumentaci PowerShellu pro konzolu Správce balíčků sady Visual Studio.

Příklady

Příklad 1: Odinstalace balíčku

Rutina Uninstall-Package odinstaluje balíčky. Parametr Name určuje balíček, který se má odinstalovat. Pokud je nainstalovaných více verzí balíčku, odinstaluje se nejnovější verze.

PS> Uninstall-Package -Name NuGet.Core

Příklad 2: Odinstalace balíčku pomocí kanálu

Get-Package vyhledá konkrétní balíček a odešle objekt SoftwareIdentity kanálu do rutiny Uninstall-Package.

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

Rutina Get-Package používá k zadání balíčku parametry Name a Required Version. Kanál odešle objekt SoftwareIdentity. Rutina Uninstall-Package obdrží objekt jako InputObject a odebere balíček.

Jako alternativu může rutina Uninstall-Package zadat hodnotu pro parametr InputObject:

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

Parametry

-AllowClobber

Přepíše zprávy upozornění týkající se konfliktů s existujícími příkazy. Přepíše existující příkazy, které mají stejný název jako nainstalované příkazy.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllowPrereleaseVersions

Umožňuje odinstalaci balíčků označených jako předběžná verze.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllVersions

Označuje, že tato rutina odinstaluje všechny verze balíčku.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Confirm

Před spuštěním cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	viz

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Destination

Určuje řetězec cesty ke vstupnímu objektu.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

NuGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ExcludeVersion

Přepněte na vyloučení čísla verze v cestě ke složce.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

NuGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Force

Přinutí příkaz ke spuštění bez výzvy k potvrzení uživatele.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ForceBootstrap

Vynutí PackageManagement automaticky nainstalovat zprostředkovatele balíčku pro zadaný balíček.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InputObject

Přijímá vstup kanálu, který určuje objekt SoftwareIdentity balíčku z rutiny Get-Package. InputObject přijímá objekt SoftwareIdentity jako hodnotu Get-Package nebo proměnnou, která objekt obsahuje.

Vlastnosti parametru

Typ:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PackageByInputObject

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-InstallUpdate

Označuje, že Uninstall-Package odinstaluje aktualizace.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaximumVersion

Určuje maximální povolenou verzi balíčku, kterou chcete odinstalovat. Pokud tento parametr nezadáte, Uninstall-Package odinstaluje nejnovější verzi balíčku.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MinimumVersion

Určuje minimální povolenou verzi balíčku, kterou chcete odinstalovat. Pokud tento parametr nepřidáte, Uninstall-Package odinstaluje nejnovější verzi balíčku, která splňuje jakoukoli verzi určenou parametrem MaximumVersion.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Name

Určuje jeden nebo více názvů balíčků. Více názvů balíčků musí být odděleno čárkami.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PackageBySearch

Position:	0
Povinné:	True
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-NoPathUpdate

NoPathUpdate se vztahuje pouze na rutinu Install-Script . NoPathUpdate je dynamický parametr přidaný poskytovatelem a není podporován Uninstall-Package.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-PackageManagementProvider

Určuje poskytovatele PackageManagement.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-ProviderName

Určuje jeden nebo více názvů zprostředkovatelů balíčků, které se mají vyhledat. Názvy zprostředkovatelů balíčků můžete získat spuštěním rutiny Get-PackageProvider.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Přípustné hodnoty:	Bootstrap, NuGet, PowerShellGet
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Poskytovatel

Sady parametrů

PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RequiredVersion

Určuje přesnou povolenou verzi balíčku, kterou chcete odinstalovat. Pokud tento parametr nepřidáte, Uninstall-Package odinstaluje nejnovější verzi balíčku, která splňuje jakoukoli verzi určenou parametrem MaximumVersion.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Scope

Určuje obor, pro který se má balíček odinstalovat. Přijatelné hodnoty pro tento parametr jsou následující:

• Aktuální uživatel
• Všichni uživatelé

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	CurrentUser, AllUsers
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

NuGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SkipDependencies

Přeskočí odinstalaci závislostí softwaru.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

NuGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

NuGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-SkipPublisherCheck

Umožňuje získat verzi balíčku, která je novější než vaše nainstalovaná verze. Například nainstalovaný balíček, který je digitálně podepsaný důvěryhodným vydavatelem, ale nová verze není digitálně podepsaná.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Type

Určuje, jestli se mají hledat balíčky pomocí modulu, skriptu nebo obojího. Přijatelné hodnoty pro tento parametr jsou následující:

• Modul
• Scénář
• Všechno

Vlastnosti parametru

Typ:	String
Default value:	None
Přípustné hodnoty:	Module, Script, All
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

PowerShellGet:PackageByInputObject

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

PowerShellGet:PackageBySearch

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-WhatIf

Ukazuje, co by se stalo, když se spustí Uninstall-Package rutina. Cmdlet se nespustil.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	False
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Wi

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Objekty SoftwareIdentity můžete připojit k této rutině.

Výstupy

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Tato rutina vrátí objekt SoftwareIdentity pro každý odinstalovaný balíček.

Poznámky

Zahrnutí zprostředkovatele balíčku do příkazu může zpřístupnit dynamické parametry rutině. Dynamické parametry jsou specifické pro zprostředkovatele balíčku. Rutina Get-Help obsahuje sady parametrů rutiny a zahrnuje sadu parametrů poskytovatele. Má například Uninstall-Package sadu parametrů PowerShellGet , která zahrnuje -NoPathUpdate, AllowClobbera SkipPublisherCheck.

Související odkazy

• about_SprávaBalíčků
• Find-Package
• Get-Package
• Install-Package
• Save-Package