functions/public/Uninstall-omsDependencyAgent.ps1
|
function Uninstall-omsDependencyAgent { <# .Synopsis Un-installs the OMS Dependency agent on remote computers. .DESCRIPTION Un-installs the OMS Dependency agent on remote computers. .EXAMPLE Uninstall-omsDependencyAgent -computerName 'computer1', 'computer2' -Verbose .NOTES Written by Ben Taylor Version 1.0, 23.06.2017 #> [CmdletBinding(SupportsShouldProcess = $True, ConfirmImpact = 'High')] [OutputType()] Param ( [Parameter(Mandatory = $false, ValueFromPipeline=$True, valuefrompipelinebypropertyname=$true, Position=0)] [ValidateNotNullOrEmpty()] [Alias('IPAddress', 'Name')] [string[]] $computerName = $env:COMPUTERNAME, [Parameter()] [System.Management.Automation.PSCredential] [System.Management.Automation.Credential()] $Credential ) Begin { $commonSessionParams = @{ ErrorAction = 'Stop' } If ($PSBoundParameters['Credential']) { $commonSessionParams.Credential = $Credential } } Process { forEach ($computer in $computerName) { try { Write-Verbose "[$(Get-Date -Format G)] - $computer - Creating Remote PS Session" $psSession = New-PSSession -ComputerName $computer -EnableNetworkAccess @commonSessionParams Write-Verbose "[$(Get-Date -Format G)] - $computer - Checking if OMS Dependency Agent is Installed" $omsInstall = Get-omsDependencyAgentInternal -computerName $computer -session $psSession if($omsInstall) { If ($Pscmdlet.ShouldProcess($computer, 'Uninstall OMS Dependency Agent')) { Write-Verbose "[$(Get-Date -Format G)] - $computer - OMS is installed so will try to uninstall" Invoke-Command -Session $psSession -ScriptBlock { Start-Process $USING:omsInstall.UninstallString -arg "/S" -Wait } -ErrorAction Stop $omsInstallStatus = Get-omsDependencyAgentInternal -computerName $computer -session $psSession -ErrorAction SilentlyContinue if($omsInstallStatus) { Write-Error "[$(Get-Date -Format G)] - $computer - OMS didn't uninstall correctly based registry check" } else { Write-Verbose "[$(Get-Date -Format G)] - $computer - OMS uninstalled correctly" } } } else { Write-Verbose "[$(Get-Date -Format G)] - $computer - OMS not installed so skipping uninstall process" } } catch { Write-Error $_ } Finally { if($null -ne $psSession) { Write-Verbose "[$(Get-Date -Format G)] - $computer - Closing Remote PS Session" Remove-PSSession $psSession -WhatIf:$false -Confirm:$false } } } } } |