Delen via


Uninstall-Package

Hiermee verwijdert u een of meer softwarepakketten.

Syntaxis

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

De Uninstall-Package cmdlet verwijdert een of meer softwarepakketten van de lokale computer. Gebruik de Get-Package cmdlet om geïnstalleerde pakketten te vinden.

Belangrijk

De opdrachten in de PackageManagement-module verschillen van de opdrachten die worden geleverd door de NuGet-module in de Package Manager-console van Visual Studio. Elke module bevat opdrachten die niet beschikbaar zijn in de andere module. Opdrachten met dezelfde naam verschillen in hun specifieke argumenten. Zie de PowerShell-referentiedocumentatie voor de Package Manager-console van Visual Studio voor meer informatie.

Voorbeelden

Voorbeeld 1: Een pakket verwijderen

De Uninstall-Package cmdlet verwijdert pakketten. Met de parameter Name geeft u het pakket op dat moet worden verwijderd. Als er meerdere versies van een pakket zijn geïnstalleerd, wordt de nieuwste versie verwijderd.

PS> Uninstall-Package -Name NuGet.Core

Voorbeeld 2: De pijplijn gebruiken om een pakket te verwijderen

Get-Package zoekt een specifiek pakket en verzendt het SoftwareIdentity-object naar de pijplijn naar de Uninstall-Package cmdlet.

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

De Get-Package cmdlet gebruikt de parameters Name en RequiredVersion om een pakket op te geven. Er wordt een SoftwareIdentity-object verzonden naar de pijplijn. De Uninstall-Package cmdlet ontvangt het object als een InputObject en verwijdert het pakket.

Als alternatief kan de Uninstall-Package cmdlet een waarde opgeven voor de parameter InputObject :

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

Parameters

-AllowClobber

Overschrijft waarschuwingsberichten over conflicten met bestaande opdrachten. Hiermee overschrijft u bestaande opdrachten met dezelfde naam als opdrachten die worden geïnstalleerd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AllowPrereleaseVersions

Staat toe dat pakketten die als voorlopige versie zijn gemarkeerd, worden verwijderd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-AllVersions

Geeft aan dat met deze cmdlet alle versies van het pakket worden verwijderd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Destination

Hiermee geeft u een tekenreeks van het pad naar het invoerobject.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ExcludeVersion

Schakel over om het versienummer uit te sluiten in het mappad.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ForceBootstrap

Dwingt PackageManagement af om de pakketprovider automatisch te installeren voor het opgegeven pakket.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Accepteert pijplijninvoer waarmee het SoftwareIdentity-object van het pakket wordt opgegeven vanuit de Get-Package cmdlet. InputObject accepteert het SoftwareIdentity-object als een Get-Package waarde of een variabele die het object bevat.

Type:Microsoft.PackageManagement.Packaging.SoftwareIdentity[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-InstallUpdate

Geeft aan dat Uninstall-Package updates worden verwijderd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MaximumVersion

Hiermee geeft u de maximaal toegestane pakketversie op die u wilt verwijderen. Als u deze parameter niet opgeeft, Uninstall-Package verwijdert u de nieuwste versie van het pakket.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-MinimumVersion

Hiermee geeft u de minimaal toegestane pakketversie op die u wilt verwijderen. Als u deze parameter niet toevoegt, Uninstall-Package verwijdert u de nieuwste versie van het pakket die voldoet aan een versie die is opgegeven door de parameter MaximumVersion .

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u een of meer pakketnamen. Meerdere pakketnamen moeten worden gescheiden door komma's.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-NoPathUpdate

NoPathUpdate is alleen van toepassing op de Install-Script cmdlet. NoPathUpdate is een dynamische parameter die door de provider wordt toegevoegd en wordt niet ondersteund door Uninstall-Package.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PackageManagementProvider

Hiermee geeft u de PackageManagement-provider .

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ProviderName

Hiermee geeft u een of meer pakketprovidernamen op om te zoeken naar pakketten. U kunt pakketprovidernamen ophalen door de cmdlet uit te Get-PackageProvider voeren.

Type:String[]
Aliassen:Provider
Geaccepteerde waarden:Bootstrap, NuGet, PowerShellGet
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-RequiredVersion

Hiermee geeft u de exacte toegestane versie van het pakket dat u wilt verwijderen. Als u deze parameter niet toevoegt, Uninstall-Package verwijdert u de nieuwste versie van het pakket die voldoet aan een versie die is opgegeven door de parameter MaximumVersion .

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Scope

Hiermee geeft u het bereik op waarvoor het pakket moet worden verwijderd. De acceptabele waarden voor deze parameter zijn als volgt:

  • HuidigeGebruiker
  • AllUsers
Type:String
Geaccepteerde waarden:CurrentUser, AllUsers
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipDependencies

Hiermee wordt het verwijderen van softwareafhankelijkheden overgeslagen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-SkipPublisherCheck

Hiermee kunt u een pakketversie ophalen die nieuwer is dan uw geïnstalleerde versie. Een geïnstalleerd pakket dat digitaal is ondertekend door een vertrouwde uitgever, maar een nieuwe versie is niet digitaal ondertekend.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Type

Hiermee geeft u op of u wilt zoeken naar pakketten met een module, een script of beide. De acceptabele waarden voor deze parameter zijn als volgt:

  • Moduul
  • Script
  • Alle
Type:String
Geaccepteerde waarden:Module, Script, All
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als Uninstall-Package cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

Microsoft.PackageManagement.Packaging.SoftwareIdentity

U kunt SoftwareIdentity-objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Deze cmdlet retourneert een SoftwareIdentity-object voor elk pakket dat is verwijderd.

Notities

Het opnemen van een pakketprovider in een opdracht kan dynamische parameters beschikbaar maken voor een cmdlet. Dynamische parameters zijn specifiek voor een pakketprovider. De Get-Help cmdlet bevat de parametersets van een cmdlet en bevat de parameterset van de provider. Bevat bijvoorbeeld Uninstall-Package de PowerShellGet-parameterset die , -NoPathUpdateAllowClobberen SkipPublisherCheck.