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.

Voorbeelden

Voorbeeld 1: Een pakket verwijderen

Met de Uninstall-Package cmdlet worden pakketten verwijderd. 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 invoerobject 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

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

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

-ForceBootstrap

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

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

-InstallUpdate

Geeft aan dat Uninstall-Package updates worden verwijderd.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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
Accept pipeline input:	False
Accept wildcard characters:	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
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
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 door de provider wordt toegevoegd en wordt niet ondersteund door Uninstall-Package.

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

-PackageManagementProvider

Hiermee geeft u de PackageManagement-provider .

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

-ProviderName

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

Type:	String[]
Aliases:	Provider
Accepted values:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Default value:	None
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipDependencies

Hiermee wordt de verwijdering van softwareafhankelijkheden overgeslagen.

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

-SkipPublisherCheck

Hiermee kunt u een pakketversie ophalen die nieuwer is dan de geïnstalleerde versie. 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
Accept pipeline input:	False
Accept wildcard characters:	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:

Module
Script
Alles

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

-WhatIf

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

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

Invoerwaarden

SoftwareIdentity

Uninstall-Package accepteert SoftwareIdentity-objecten uit de pijplijn als invoer.

Uitvoerwaarden

SoftwareIdentity

Uninstall-Package retourneert een SoftwareIdentity-object voor elk pakket dat is verwijderd.

Notities

Als u een pakketprovider in een opdracht opgeeft, kunt u 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. De PowerShellGet-parameterset bevat -NoPathUpdatebijvoorbeeld Uninstall-Package , AllowClobberen SkipPublisherCheck.