Uninstall-Package

  • Referentie
Module:
PackageManagement

Hiermee verwijdert u een of meer softwarepakketten.

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

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 module PackageManagement zijn anders dan de opdrachten die worden geleverd door de NuGet-module in de Package Manager-console van Visual Studio. Elke module heeft 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 in 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. Een SoftwareIdentity-object wordt door de pijplijn verzonden. 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. Bestaande opdrachten die dezelfde naam hebben als opdrachten die worden geïnstalleerd, worden overschreven.

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

-AllowPrereleaseVersions

Hiermee staat u toe dat pakketten die zijn gemarkeerd als voorlopige versie, worden verwijderd.

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

-AllVersions

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

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

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-Destination

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

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

-ExcludeVersion

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

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

-Force

Hiermee dwingt u de opdracht uit te voeren zonder om bevestiging van de gebruiker te vragen.

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

-ForceBootstrap

Hiermee dwingt u PackageManagement om automatisch de pakketprovider voor het opgegeven pakket te installeren.

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

-InputObject

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

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

-InstallUpdate

Geeft aan dat Uninstall-Package updates worden verwijderd.

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

-MaximumVersion

Hiermee geeft u de maximaal toegestane pakketversie 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

Hiermee geeft u de minimaal toegestane pakketversie 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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

-NoPathUpdate

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

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

-PackageManagementProvider

Hiermee geeft u de packagemanagement-provider .

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

-ProviderName

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

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

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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Scope

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

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

-SkipDependencies

Hiermee wordt het verwijderen van softwareafhankelijkheden overgeslagen.

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

-SkipPublisherCheck

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

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

-Type

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

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

-WhatIf

Laat zien wat er gebeurt als Uninstall-Package de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

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

Invoerwaarden

Microsoft.PackageManagement.Packaging.SoftwareIdentity

U kunt SoftwareIdentity-objecten doorspeken naar deze cmdlet.

Uitvoerwaarden

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Deze cmdlet retourneert een SoftwareIdentity-object voor elk pakket dat wordt 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. Heeft bijvoorbeeld Uninstall-Package de PowerShellGet-parameterset die , AllowClobberen SkipPublisherCheckbevat-NoPathUpdate.