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
, AllowClobber
a SkipPublisherCheck
.