Uninstall-Package

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.