Uninstall-Package
Uninstalls one or more software packages.
Syntaxis
Uninstall-Package
[-InputObject] <SoftwareIdentity[]>
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
PackageBySearch
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>]
NuGet:PackageBySearch
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>]
PowerShellGet:PackageBySearch
Uninstall-Package
[-AllVersions]
[-Force]
[-ForceBootstrap]
[-WhatIf]
[-Confirm]
[-Scope <String>]
[-PackageManagementProvider <String>]
[-Type <String>]
[-AllowClobber]
[-SkipPublisherCheck]
[-InstallUpdate]
[-NoPathUpdate]
[-AllowPrereleaseVersions]
[<CommonParameters>]
Description
The Uninstall-Package
cmdlet uninstalls one or more software packages from the local computer. To
find installed packages, use the Get-Package
cmdlet.
Important
The commands contained in the PackageManagement module are different than the commands
provided by the NuGet module in the Package Manager Console of Visual Studio. Each module has
commands that are not available in the other. Commands with the same name differ in their specific
arguments. For more information, see the PowerShell reference documentation for the
Package Manager Console of Visual Studio.
Voorbeelden
Example 1: Uninstall a package
The Uninstall-Package
cmdlet uninstalls packages. The Name parameter specifies the package to
uninstall. If multiple versions of a package are installed, the newest version is uninstalled.
PS> Uninstall-Package -Name NuGet.Core
Example 2: Use the pipeline to uninstall a package
Get-Package
locates a specific package and sends the SoftwareIdentity object down the pipeline
to the Uninstall-Package
cmdlet.
PS> Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 | Uninstall-Package
The Get-Package
cmdlet uses the Name and RequiredVersion parameters to specify a package.
A SoftwareIdentity object is sent down the pipeline. The Uninstall-Package
cmdlet receives the
object as an InputObject and removes the package.
As an alternative, the Uninstall-Package
cmdlet can specify a value for the InputObject
parameter:
Uninstall-Package -InputObject ( Get-Package -Name NuGet.Core -RequiredVersion 2.14.0 )
Parameters
-AllowClobber
Overrides warning messages about conflicts with existing commands. Overwrites existing commands that
have the same name as commands being installed.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PowerShellGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-AllowPrereleaseVersions
Allows packages marked as prerelease to be uninstalled.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PowerShellGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-AllVersions
Indicates that this cmdlet uninstalls all versions of the package.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Confirm
Prompts you for confirmation before running the cmdlet.
Parametereigenschappen
Type: SwitchParameter
Default value: False
Ondersteunt jokertekens: False
DontShow: False
Aliassen: cf
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Destination
Specifies a string of the path to the input object.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
NuGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
NuGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ExcludeVersion
Switch to exclude the version number in the folder path.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
NuGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
NuGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Force
Forces the command to run without asking for user confirmation.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ForceBootstrap
Forces PackageManagement to automatically install the package provider for the specified
package.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
Accepts pipeline input that specifies the package's SoftwareIdentity object from the
Get-Package
cmdlet. InputObject accepts the SoftwareIdentity object as a Get-Package
value or a variable that contains the object.
Type: Microsoft.PackageManagement.Packaging.SoftwareIdentity [ ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
PackageByInputObject
Position: 0
Verplicht: True
Waarde uit pijplijn: True
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-InstallUpdate
Indicates that Uninstall-Package
uninstalls updates.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PowerShellGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-MaximumVersion
Specifies the maximum allowed package version that you want to uninstall. If you don't specify this
parameter, Uninstall-Package
uninstalls the package's newest version.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-MinimumVersion
Specifies the minimum allowed package version that you want to uninstall. If you don't add this
parameter, Uninstall-Package
uninstalls the package's newest version that satisfies any version
specified by the MaximumVersion parameter.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Name
Specifies one or more package names. Multiple package names must be separated by commas.
Parametereigenschappen
Type: String [ ]
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PackageBySearch
Position: 0
Verplicht: True
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-NoPathUpdate
NoPathUpdate only applies to the Install-Script
cmdlet. NoPathUpdate is a dynamic
parameter added by the provider and isn't supported by Uninstall-Package
.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PowerShellGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-PackageManagementProvider
Specifies the PackageManagement provider.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PowerShellGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-ProviderName
Specifies one or more package provider names to search for packages. You can get package provider
names by running the Get-PackageProvider
cmdlet.
Parametereigenschappen
Type: String [ ]
Default value: None
Geaccepteerde waarden: Bootstrap, NuGet, PowerShellGet
Ondersteunt jokertekens: False
DontShow: False
Aliassen: Provider
Parametersets
PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: True
Waarde van resterende argumenten: False
-RequiredVersion
Specifies the exact allowed version of the package that you want to uninstall. If you don't add this
parameter, Uninstall-Package
uninstalls the package's newest version that satisfies any version
specified by the MaximumVersion parameter.
Parametereigenschappen
Type: String
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Scope
Specifies the scope for which to uninstall the package. The acceptable values for this parameter are
as follows:
Parametereigenschappen
Type: String
Default value: None
Geaccepteerde waarden: CurrentUser, AllUsers
Ondersteunt jokertekens: False
DontShow: False
Parametersets
NuGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
NuGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-SkipDependencies
Skips the uninstallation of software dependencies.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
NuGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
NuGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-SkipPublisherCheck
Allows you to get a package version that is newer than your installed version. For example, an
installed package that is digitally signed by a trusted publisher but a new version isn't digitally
signed.
Parametereigenschappen
Type: SwitchParameter
Default value: None
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PowerShellGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-Type
Specifies whether to search for packages with a module, a script, or both. The acceptable values for
this parameter are as follows:
Parametereigenschappen
Type: String
Default value: None
Geaccepteerde waarden: Module, Script, All
Ondersteunt jokertekens: False
DontShow: False
Parametersets
PowerShellGet:PackageByInputObject
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
PowerShellGet:PackageBySearch
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
-WhatIf
Shows what would happen if Uninstall-Package
cmdlet is run. The cmdlet isn't run.
Parametereigenschappen
Type: SwitchParameter
Default value: False
Ondersteunt jokertekens: False
DontShow: False
Aliassen: wi
Parametersets
(All)
Position: Named
Verplicht: False
Waarde uit pijplijn: False
Waarde uit pijplijn op eigenschapsnaam: False
Waarde van resterende argumenten: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters .
You can pipe SoftwareIdentity objects to this cmdlet.
Uitvoerwaarden
Microsoft.PackageManagement.Packaging.SoftwareIdentity
This cmdlet returns a SoftwareIdentity object for each package uninstalled.
Notities
Including a package provider in a command can make dynamic parameters available to a cmdlet. Dynamic
parameters are specific to a package provider. The Get-Help
cmdlet lists a cmdlet's parameter sets
and includes the provider's parameter set. For example, Uninstall-Package
has the
PowerShellGet parameter set that includes -NoPathUpdate
, AllowClobber
, and
SkipPublisherCheck
.