< Back
Uninstall-ChocolateyPackage
Post
NAME Uninstall-ChocolateyPackage
SYNOPSIS
Uninstalls a Chocolatey package or a list of packages.
SYNTAX
Uninstall-ChocolateyPackage [-Name] <String[]> [[-Version] <String>] [[-Source] <Object>] [[-Credential]
<PSCredential>] [-Force] [[-CacheLocation] <String>] [-NoProgress] [-AcceptLicense] [[-Timeout] <Int32>]
[[-UninstallArguments] <String>] [-OverrideArguments] [-NotSilent] [-ApplyArgsToDependencies] [-SideBySide]
[-IgnoreDependencies] [-ForceDependencies] [-SkipPowerShell] [-ignorePackageCodes] [-UsePackageCodes]
[-StopOnFirstFailure] [-AutoUninstaller] [-SkipAutoUninstaller] [-FailOnAutouninstaller]
[-IgnoreAutoUninstallerFailure] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Once the Chocolatey Software has been installed (see Install-ChocolateySoftware) this command
allows you to uninstall Software installed by Chocolatey,
or synced from Add-remove program (Business edition).
PARAMETERS
-Name <String[]>
Package Name to uninstall, either from a configured source, a specified one such as a folder,
or the current directory '.'
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Version <String>
Version - A specific version to install.
Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Source <Object>
Source - The source to find the package(s) to install. Special sources
include: ruby, webpi, cygwin, windowsfeatures, and python. To specify
more than one source, pass it with a semi-colon separating the values (-
e.g. "'source1;source2'"). Defaults to default feeds.
Required? false
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Credential <PSCredential>
Credential used with authenticated feeds. Defaults to empty.
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Force [<SwitchParameter>]
Force - force the behavior. Do not use force during normal operation -
it subverts some of the smart behavior for commands.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-CacheLocation <String>
CacheLocation - Location for download cache, defaults to %TEMP% or value
in chocolatey.config file.
Required? false
Position? 5
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NoProgress [<SwitchParameter>]
Do Not Show Progress - Do not show download progress percentages.
Available in 0.10.4+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-AcceptLicense [<SwitchParameter>]
AcceptLicense - Accept license dialogs automatically. Reserved for future use.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Timeout <Int32>
CommandExecutionTimeout (in seconds) - The time to allow a command to
finish before timing out. Overrides the default execution timeout in the
configuration of 2700 seconds. '0' for infinite starting in 0.10.4.
Required? false
Position? 6
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-UninstallArguments <String>
UninstallArguments - Uninstall Arguments to pass to the native installer
in the package. Defaults to unspecified.
Required? false
Position? 7
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-OverrideArguments [<SwitchParameter>]
OverrideArguments - Should uninstall arguments be used exclusively
without appending to current package passed arguments? Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NotSilent [<SwitchParameter>]
NotSilent - Do not uninstall this silently. Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ApplyArgsToDependencies [<SwitchParameter>]
Apply Install Arguments To Dependencies - Should install arguments be
applied to dependent packages? Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SideBySide [<SwitchParameter>]
AllowMultipleVersions - Should multiple versions of a package be
installed? Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-IgnoreDependencies [<SwitchParameter>]
IgnoreDependencies - Ignore dependencies when installing package(s).
Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ForceDependencies [<SwitchParameter>]
RemoveDependencies - Uninstall dependencies when uninstalling package(s).
Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SkipPowerShell [<SwitchParameter>]
Skip Powershell - Do not run chocolateyUninstall.ps1. Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ignorePackageCodes [<SwitchParameter>]
IgnorePackageExitCodes - Exit with a 0 for success and 1 for non-succes-s,
no matter what package scripts provide for exit codes. Overrides the
default feature 'usePackageExitCodes' set to 'True'. Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-UsePackageCodes [<SwitchParameter>]
UsePackageExitCodes - Package scripts can provide exit codes. Use those
for choco's exit code when non-zero (this value can come from a
dependency package). Chocolatey defines valid exit codes as 0, 1605,
1614, 1641, 3010. Overrides the default feature 'usePackageExitCodes'
set to 'True'.
Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-StopOnFirstFailure [<SwitchParameter>]
Stop On First Package Failure - stop running install, upgrade or
uninstall on first package failure instead of continuing with others.
Overrides the default feature 'stopOnFirstPackageFailure' set to 'False'.
Available in 0.10.4+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-AutoUninstaller [<SwitchParameter>]
UseAutoUninstaller - Use auto uninstaller service when uninstalling.
Overrides the default feature 'autoUninstaller' set to 'True'.
Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SkipAutoUninstaller [<SwitchParameter>]
SkipAutoUninstaller - Skip auto uninstaller service when uninstalling.
Overrides the default feature 'autoUninstaller' set to 'True'. Available
in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-FailOnAutouninstaller [<SwitchParameter>]
FailOnAutoUninstaller - Fail the package uninstall if the auto
uninstaller reports and error. Overrides the default feature
'failOnAutoUninstaller' set to 'False'. Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-IgnoreAutoUninstallerFailure [<SwitchParameter>]
Ignore Auto Uninstaller Failure - Do not fail the package if auto
uninstaller reports an error. Overrides the default feature
'failOnAutoUninstaller' set to 'False'. Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
https://github.com/chocolatey/choco/wik ... suninstall
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Uninstall-ChocolateyPackage -Name Putty
RELATED LINKS
SYNOPSIS
Uninstalls a Chocolatey package or a list of packages.
SYNTAX
Uninstall-ChocolateyPackage [-Name] <String[]> [[-Version] <String>] [[-Source] <Object>] [[-Credential]
<PSCredential>] [-Force] [[-CacheLocation] <String>] [-NoProgress] [-AcceptLicense] [[-Timeout] <Int32>]
[[-UninstallArguments] <String>] [-OverrideArguments] [-NotSilent] [-ApplyArgsToDependencies] [-SideBySide]
[-IgnoreDependencies] [-ForceDependencies] [-SkipPowerShell] [-ignorePackageCodes] [-UsePackageCodes]
[-StopOnFirstFailure] [-AutoUninstaller] [-SkipAutoUninstaller] [-FailOnAutouninstaller]
[-IgnoreAutoUninstallerFailure] [-WhatIf] [-Confirm] [<CommonParameters>]
DESCRIPTION
Once the Chocolatey Software has been installed (see Install-ChocolateySoftware) this command
allows you to uninstall Software installed by Chocolatey,
or synced from Add-remove program (Business edition).
PARAMETERS
-Name <String[]>
Package Name to uninstall, either from a configured source, a specified one such as a folder,
or the current directory '.'
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Version <String>
Version - A specific version to install.
Required? false
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Source <Object>
Source - The source to find the package(s) to install. Special sources
include: ruby, webpi, cygwin, windowsfeatures, and python. To specify
more than one source, pass it with a semi-colon separating the values (-
e.g. "'source1;source2'"). Defaults to default feeds.
Required? false
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Credential <PSCredential>
Credential used with authenticated feeds. Defaults to empty.
Required? false
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Force [<SwitchParameter>]
Force - force the behavior. Do not use force during normal operation -
it subverts some of the smart behavior for commands.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-CacheLocation <String>
CacheLocation - Location for download cache, defaults to %TEMP% or value
in chocolatey.config file.
Required? false
Position? 5
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NoProgress [<SwitchParameter>]
Do Not Show Progress - Do not show download progress percentages.
Available in 0.10.4+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-AcceptLicense [<SwitchParameter>]
AcceptLicense - Accept license dialogs automatically. Reserved for future use.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Timeout <Int32>
CommandExecutionTimeout (in seconds) - The time to allow a command to
finish before timing out. Overrides the default execution timeout in the
configuration of 2700 seconds. '0' for infinite starting in 0.10.4.
Required? false
Position? 6
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-UninstallArguments <String>
UninstallArguments - Uninstall Arguments to pass to the native installer
in the package. Defaults to unspecified.
Required? false
Position? 7
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-OverrideArguments [<SwitchParameter>]
OverrideArguments - Should uninstall arguments be used exclusively
without appending to current package passed arguments? Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-NotSilent [<SwitchParameter>]
NotSilent - Do not uninstall this silently. Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ApplyArgsToDependencies [<SwitchParameter>]
Apply Install Arguments To Dependencies - Should install arguments be
applied to dependent packages? Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SideBySide [<SwitchParameter>]
AllowMultipleVersions - Should multiple versions of a package be
installed? Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-IgnoreDependencies [<SwitchParameter>]
IgnoreDependencies - Ignore dependencies when installing package(s).
Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ForceDependencies [<SwitchParameter>]
RemoveDependencies - Uninstall dependencies when uninstalling package(s).
Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SkipPowerShell [<SwitchParameter>]
Skip Powershell - Do not run chocolateyUninstall.ps1. Defaults to false.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-ignorePackageCodes [<SwitchParameter>]
IgnorePackageExitCodes - Exit with a 0 for success and 1 for non-succes-s,
no matter what package scripts provide for exit codes. Overrides the
default feature 'usePackageExitCodes' set to 'True'. Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-UsePackageCodes [<SwitchParameter>]
UsePackageExitCodes - Package scripts can provide exit codes. Use those
for choco's exit code when non-zero (this value can come from a
dependency package). Chocolatey defines valid exit codes as 0, 1605,
1614, 1641, 3010. Overrides the default feature 'usePackageExitCodes'
set to 'True'.
Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-StopOnFirstFailure [<SwitchParameter>]
Stop On First Package Failure - stop running install, upgrade or
uninstall on first package failure instead of continuing with others.
Overrides the default feature 'stopOnFirstPackageFailure' set to 'False'.
Available in 0.10.4+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-AutoUninstaller [<SwitchParameter>]
UseAutoUninstaller - Use auto uninstaller service when uninstalling.
Overrides the default feature 'autoUninstaller' set to 'True'.
Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-SkipAutoUninstaller [<SwitchParameter>]
SkipAutoUninstaller - Skip auto uninstaller service when uninstalling.
Overrides the default feature 'autoUninstaller' set to 'True'. Available
in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-FailOnAutouninstaller [<SwitchParameter>]
FailOnAutoUninstaller - Fail the package uninstall if the auto
uninstaller reports and error. Overrides the default feature
'failOnAutoUninstaller' set to 'False'. Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-IgnoreAutoUninstallerFailure [<SwitchParameter>]
Ignore Auto Uninstaller Failure - Do not fail the package if auto
uninstaller reports an error. Overrides the default feature
'failOnAutoUninstaller' set to 'False'. Available in 0.9.10+.
Required? false
Position? named
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
NOTES
https://github.com/chocolatey/choco/wik ... suninstall
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Uninstall-ChocolateyPackage -Name Putty
RELATED LINKS