functions/Uninstall-DbaWatchUpdate.ps1

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
Function Uninstall-DbaWatchUpdate
{
<#
.SYNOPSIS
Removes the scheduled task created for Watch-DbaUpdate by Install-DbaWatchUpdate so that notifications no longer pop up.
 
.DESCRIPTION
Removes the scheduled task created for Watch-DbaUpdate by Install-DbaWatchUpdate so that notifications no longer pop up.
 
.NOTES
Tags: JustForFun
dbatools PowerShell module (https://dbatools.io, clemaire@gmail.com)
Copyright (C) 2016 Chrissy LeMaire
 
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
 
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>.
 
.LINK
https://dbatools.io/Uninstall-DbaWatchUpdate
 
.EXAMPLE
Uninstall-DbaWatchUpdate
 
Removes the scheduled task created by Install-DbaWatchUpdate.
#>
    
    process
    {
        if (([Environment]::OSVersion).Version.Major -lt 10)
        {
            Write-Warning "This command only supports Windows 10 and above"
            return
        }
        
        $script = {
            try
            {
                $task = Get-ScheduledTask -TaskName "dbatools version check" -ErrorAction SilentlyContinue
                
                if ($null -eq $task)
                {
                    Write-Warning "Task doesn't exist. Skipping removal."
                }
                else
                {
                    Write-Output "Removing watchupdate.xml"
                    $file = "$env:LOCALAPPDATA\dbatools\watchupdate.xml"
                    Remove-Item $file -ErrorAction SilentlyContinue
                    
                    Write-Output "Removing Scheduled Task 'dbatools version check'"
                    $task | Unregister-ScheduledTask -Confirm:$false -ErrorAction Stop
                    
                    Write-Output "Task removed"
                    
                    Start-Sleep -Seconds 2
                }
            }
            catch
            {
                Write-Warning "Task could not be deleted. Please remove 'dbatools version check' manually."
            }
        }
        # Needs admin creds to remove the task because of the way it was setup
        
        $task = Get-ScheduledTask -TaskName "dbatools version check" -ErrorAction SilentlyContinue
        
        if ($null -eq $task)
        {
            Write-Warning "dbatools update watcher not installed"
            return
        }
        
        If (-not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator"))
        {
            Write-Warning "Removal of the scheduled task requires elevated permissions because of the way it had to be setup."
            Start-Process powershell -Verb runAs -ArgumentList Uninstall-DbaWatchUpdate -Wait
        }
        else
        {
            Invoke-Command -ScriptBlock $script
        }
        
        Write-Output "All done!"
    }
}