forked from adbertram/Random-PowerShell-Work
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
176 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,176 @@ | ||
| <# | ||
| .SYNOPSIS | ||
| This script removes any software registered via Windows Installer from a computer. | ||
| .NOTES | ||
| Created on: 5/19/2014 2:59 PM | ||
| Created by: Adam Bertram | ||
| Filename: Remove-Software.ps1 | ||
| Requirements: Installed SCCM Client, the application's MSI (if no locally cached copy) | ||
| .DESCRIPTION | ||
| This script searches the local computer for a specified application matching a name. It then checks to ensure the locally cached MSI exists in case the original source files are needed. It then proceeds with the uninstall string if so. If not, it will utilize the MSI included in the current directory to kick off the uninstall. | ||
| .EXAMPLE | ||
| .\Remove-Software.ps1 -ProductName 'Adobe Reader' -MsiName 'setup.msi' -KillProcess 'proc1','proc2' .EXAMPLE .\Remove-Software.ps1 -ProductName 'Adobe Reader' -Wait | ||
| .EXAMPLE .\Remove-Software.ps1 -ProductName 'Adobe Reader' -Computername COMPUTERNAME | ||
| .PARAMETER | ||
| ProductName This is the name of the application to search for. .PARAMETER Computername | ||
| This is the name of the computer you'd like to remove the software from. | ||
| .PARAMETER MsiName | ||
| This is the name of the MSI file that exists in the current directory. If no MSI file is specified, the script will search for and use the first MSI it finds in the current directory. | ||
| .PARAMETER KillProcess | ||
| One or more process names to attempt to kill prior to software uninstall | ||
| .PARAMETER PreActions | ||
| This is a scriptblock in which you can pass to the script that will execute any arbitrary commands you'd like before the uninstall takes place. This is handy for things specific to the software you are uninstalling. | ||
| .PARAMETER PostActions | ||
| This is a scriptblock in which you can pass to the script that will execute any arbitrary commands you'd like after the uninstall takes place. This is handy for things specific to the software you are uninstalling. | ||
| .PARAMETER Wait | ||
| Use this switch to wait on the script to finish | ||
| #> | ||
|
|
||
| [CmdletBinding(DefaultParameterSetName = 'Local')] | ||
| param ( | ||
| [Parameter(Mandatory = $True, | ||
| ValueFromPipeline = $True, | ||
| ValueFromPipelineByPropertyName = $True)] | ||
| [string]$ProductName, | ||
| [Parameter(Mandatory = $False, | ||
| ValueFromPipeline = $True, | ||
| ValueFromPipelineByPropertyName = $True)] | ||
| [string]$Computername = 'localhost', | ||
| [Parameter(Mandatory = $False, | ||
| ValueFromPipeline = $False, | ||
| ValueFromPipelineByPropertyName = $False)] | ||
| [string]$MsiName, | ||
| [Parameter(Mandatory = $False, | ||
| ValueFromPipeline = $False, | ||
| ValueFromPipelineByPropertyName = $False)] | ||
| [string[]]$KillProcess, | ||
| [Parameter(Mandatory = $False, | ||
| ValueFromPipeline = $False, | ||
| ValueFromPipelineByPropertyName = $False)] | ||
| [scriptblock]$PreActions, | ||
| [Parameter(Mandatory = $False, | ||
| ValueFromPipeline = $False, | ||
| ValueFromPipelineByPropertyName = $False)] | ||
| [scriptblock]$PostActions, | ||
| [Parameter(Mandatory = $False, | ||
| ValueFromPipeline = $False, | ||
| ValueFromPipelineByPropertyName = $False)] | ||
| [switch]$Wait | ||
| ) | ||
|
|
||
| begin { | ||
| $WorkingDir = $MyInvocation.MyCommand.Path | Split-Path -Parent | ||
| $SccmClientWmiNamespace = 'root\cimv2\sms' | ||
|
|
||
| if ($MsiName) { | ||
| $PackageMsiFilePath = "$WorkingDir\$MsiName" | ||
| } | ||
| } | ||
|
|
||
| process { | ||
| try { | ||
| if ($KillProcess) { | ||
| foreach ($process in $KillProcess) { | ||
| Write-Verbose "Attempting to stop process $process..." | ||
| if ($Computername -ne 'localhost') { | ||
| $WmiProcess = Get-WmiObject -Class Win32_Process -ComputerName $ComputerName -Filter "name='$process`.exe'" | ||
| if ($WmiProcess) { | ||
| $WmiProcess.Terminate() | Out-Null | ||
| } | ||
| } else { | ||
| Stop-Process -Name $process -Force -ErrorAction 'SilentlyContinue' | ||
| } | ||
| } | ||
| } | ||
|
|
||
| if ($PreActions) { | ||
| & $PreActions | ||
| } | ||
|
|
||
| $Query = "SELECT * FROM SMS_InstalledSoftware WHERE ARPDisplayName LIKE '%$ProductName%'" | ||
| Write-Verbose "Querying computer for the existence of $ProductName..." | ||
| $InstalledSoftware = Get-WmiObject -ComputerName $Computername -Namespace $SccmClientWmiNamespace -Query $Query | ||
|
|
||
| if ($InstalledSoftware) { | ||
| $InstalledSoftware | foreach { | ||
| Write-Verbose "$ProductName ($($_.SoftwareCode)) found installed..." | ||
| Write-Verbose "Ensuring there's a valid uninstall string found..." | ||
| if ($_.UninstallString.Trim() -match 'msiexec.exe /x{(\{){0,1}[0-9a-fA-F]{8}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{4}\-[0-9a-fA-F]{12}(\}){0,1}}') { | ||
| Write-Verbose "Valid uninstall string found for $ProductName..." | ||
| Write-Verbose "Ensuring a locally cached copy of the $ProductName MSI exists..." | ||
| if ($Computername -ne 'localhost') { | ||
| $LocalPackageFilePathDrive = ($_.LocalPackage | Split-Path -Qualifier).Replace(':', '') | ||
| $LocalPackageFilePath = "\\$Computername\$LocalPackageFilePathDrive`$$($_.LocalPackage | Split-Path -NoQualifier)" | ||
| } else { | ||
| $LocalPackageFilePath = $_.LocalPackage | ||
| } | ||
| if (Test-Path $LocalPackageFilePath) { | ||
| Write-Verbose "Install package $LocalPackageFilePath exists on the file system. Using locally cached copy for uninstall..." | ||
| $UninstallSyntax = "$($_.UninstallString) /qn" | ||
| } else { | ||
| Write-Verbose "Install package $LocalPackageFilePath not found on file system..." | ||
| if (!$PackageMsiFilePath) { | ||
| Write-Verbose "No MSIName specified as param. Searching current directory for MSI..." | ||
| $LocalMsis = Get-ChildItem $WorkingDir -Filter '*.msi' | Select -first 1 | ||
| if (!$LocalMsis) { | ||
| throw 'No MSIs found to support uninstall' | ||
| } else { | ||
| $PackageMsiFilePath = $LocalMsis.FullName | ||
| } | ||
| } elseif (!(Test-Path $PackageMsiFilePath)) { | ||
| throw 'Package MSI needed but MSI specified does not exist in current directory' | ||
| } else { | ||
| ##TODO: Check MSI's product name and version to ensure match | ||
| #Write-Verbose "Checking $PackageMsiFilePath for matching product name and version..." | ||
| #$MsiProperties = Get-Msi $PackageMsiFilePath | ||
| #if (($MsiProperties['ProductName'] -notlike '*$ProductName*') -or ($MsiProperties['ProductVersion'] -ne $_.ProductVersion)) { | ||
| # throw 'Package MSI is not the same product as being uninstalled' | ||
| #} | ||
| } | ||
| $UninstallSyntax = "/x `"$PackageMsiFilePath`" /qn" | ||
| } | ||
| $MsiExecArgs = $UninstallSyntax.ToLower().TrimStart('msiexec.exe ') | ||
| Write-Verbose "Beginning uninstall using syntax: msiexec.exe $MsiExecArgs on $Computername" | ||
|
|
||
| if ($Computername -ne 'localhost') { | ||
| ##TODO: Add an option to do PS Remoting | ||
| $NewProcess = ([WMICLASS]"\\$computername\Root\CIMV2:Win32_Process").create("msiexec $MsiExecArgs") | ||
| if ($NewProcess.ReturnValue -eq 0) { | ||
| Write-Verbose "Successfully started remote msiexec process on $Computername." | ||
| if ($Wait.IsPresent) { | ||
| Write-Verbose "Waiting for process ID $($NewProcess.ProcessID) on $Computername." | ||
| while (Get-Process -Id $NewProcess.ProcessID -ComputerName $Computername -ErrorAction 'SilentlyContinue') { | ||
| sleep 1 | ||
| } | ||
| Write-Verbose "Process ID $($NewProcess.ProcessID) has exited" | ||
| } | ||
|
|
||
| } else { | ||
| throw "Software uninstall failed on $Computername. Exit code was $ExitCode" | ||
| } | ||
| } else { | ||
| if ($Wait.IsPresent) { | ||
| Write-Verbose 'Waiting on uninstall to finish...' | ||
| Start-Process msiexec.exe -ArgumentList $MsiExecArgs -Wait -NoNewWindow | ||
| } else { | ||
| Start-Process msiexec.exe -ArgumentList $MsiExecArgs -NoNewWindow | ||
| } | ||
| } | ||
|
|
||
| } else { | ||
| Write-Warning "Invalid uninstall string found for $ProductName..." | ||
| } | ||
| } | ||
| } else { | ||
| Write-Warning "$ProductName seems to already be uninstalled" | ||
| } | ||
| } catch { | ||
| Write-Error $_.Exception.Message | ||
| } | ||
| } | ||
|
|
||
| end { | ||
| if ($PostActions) { | ||
| & $PostActions | ||
| } | ||
| } |