Public/Packages/Uninstall-ChocoPackage.ps1
|
Function Uninstall-ChocoPackage { <# .SYNOPSIS Uninstalls a chocolatey package. Doesn't asks for confirmation by default. .DESCRIPTION Uninstalls a chocolatey package. Doesn't asks for confirmation by default. Just like Chocolatey, you may need admin rights to uninstall a package. This function also accepts pipeline input. .PARAMETER Name The name of the package to uninstall. .PARAMETER Force Will force the uninstallation of the package. .PARAMETER AskForConfirmation Ask for confirmation before uninstalling the package. .EXAMPLE Uninstall-ChocoPackage -Name vlc .EXAMPLE Uninstall-ChocoPackage -Name vlc -Force .EXAMPLE Uninstall-ChocoPackage -Name vlc -AskForConfirmation .EXAMPLE Get-ChocoPackage -Name vlc | Uninstall-ChocoPackage .OUTPUTS PSCustomObject #> [OutputType([PSCustomObject])] [CmdletBinding()] param( [Parameter(Mandatory = $true, Position = 0, ValueFromPipelineByPropertyName = $true)] [String] $Name, [Switch] $Force, [Switch] $AskForConfirmation ) begin { if (-Not (Test-ChocoInstalled)) { Write-Error "Chocolatey is not installed. Please install it first." return } [String[]]$Arguments = "uninstall" if ($Force) { $Arguments += "--force" } if (-Not ($AskForConfirmation)) { $Arguments += "-y" } } process { $Arguments += $Name } end { $CommandOutput = Invoke-ChocoCommand $Arguments if ($CommandOutput.Status -eq "Error" -and $CommandOutput.RawOutput -like "*Cannot uninstall a non-existent package.*") { $Status = "Cannot uninstall a non-existent package" } elseif ($CommandOutput.Status -eq "Success") { if ($CommandOutput.RawOutput -like "*has been successfully uninstalled.*") { $Status = "Uninstalled" } } Return [PSCustomObject]@{ Name = $Name Status = $Status } } } |