Uninstall-Package

Modul:

PackageManagement

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

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

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 konkrétních argumentech. Další informace najdete v referenční dokumentaci k 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 v kanálu do rutiny Uninstall-Package .

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

Rutina Get-Package používá parametry Name a RequiredVersion k určení balíčku. Objekt SoftwareIdentity se odešle do kanálu. Rutina Uninstall-Package přijme objekt jako InputObject a odebere balíček.

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

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

Parametry

-AllowClobber

Přepíše upozornění na konflikty s existujícími příkazy. Přepíše existující příkazy, které mají stejný název jako instalované příkazy.

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

-AllowPrereleaseVersions

Umožňuje odinstalovat balíčky označené jako předběžné verze.

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

-AllVersions

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

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

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

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

-Destination

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

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

-ExcludeVersion

Přepnutím vyloučíte číslo verze v cestě ke složce.

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-ForceBootstrap

Vynutí , aby packageManagement automaticky nainstaloval zprostředkovatele balíčku pro zadaný balíček.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 Get-Package hodnotu nebo proměnnou, která obsahuje objekt .

Type:	Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-InstallUpdate

Označuje, že Uninstall-Package se odinstalují aktualizace.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .

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

-Name

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

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

-NoPathUpdate

NoPathUpdate se vztahuje pouze na rutinu Install-Script . NoPathUpdate je dynamický parametr přidaný zprostředkovatelem a nepodporuje ho Uninstall-Package.

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

-PackageManagementProvider

Určuje zprostředkovatele PackageManagement .

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

-ProviderName

Určuje jeden nebo více názvů zprostředkovatelů balíčků pro vyhledání balíčků. Názvy zprostředkovatelů balíčků můžete získat spuštěním rutiny 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

Určuje přesnou povolenou verzi balíčku, který 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 .

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

-Scope

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

• Currentuser
• Všichniuživatelé

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipDependencies

Přeskočí odinstalaci softwarových závislostí.

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

-SkipPublisherCheck

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

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

-Type

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

• Modul
• Skript
• Vše

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

-WhatIf

Ukazuje, co by se stalo, když Uninstall-Package se rutina spustí. Rutina se nespustí.

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

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

Související odkazy

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