functions/Install-DbaWatchUpdate.ps1
function Install-DbaWatchUpdate { <# .SYNOPSIS Adds the scheduled task to support Watch-DbaUpdate. .DESCRIPTION Adds the scheduled task to support Watch-DbaUpdate. .NOTES Tags: JustForFun, Module Website: https://dbatools.io Copyright: (C) Chrissy LeMaire, clemaire@gmail.com License: GNU GPL v3 https://opensource.org/licenses/GPL-3.0 .LINK https://dbatools.io/Install-DbaWatchUpdate .EXAMPLE Install-DbaWatchUpdate Adds the scheduled task needed by Watch-DbaUpdate #> process { if (([Environment]::OSVersion).Version.Major -lt 10) { Write-Warning "This command only supports Windows 10 and above" return } $script = { try { # create a task, check every 3 hours $action = New-ScheduledTaskAction -Execute 'powershell.exe' -Argument '-NoProfile -NoLogo -NonInteractive -WindowStyle Hidden Watch-DbaUpdate' $trigger = New-ScheduledTaskTrigger -Once -At (Get-Date).Date -RepetitionInterval (New-TimeSpan -Hours 1) $principal = New-ScheduledTaskPrincipal -LogonType S4U -UserId (whoami) $settings = New-ScheduledTaskSettingsSet -ExecutionTimeLimit ([timespan]::Zero) -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable -RunOnlyIfNetworkAvailable -DontStopOnIdleEnd $task = Register-ScheduledTask -Principal $principal -TaskName 'dbatools version check' -Action $action -Trigger $trigger -Settings $settings -ErrorAction Stop } catch { # keep moving } } if ($null -eq (Get-ScheduledTask -TaskName "dbatools version check" -ErrorAction SilentlyContinue)) { # Needs admin creds to setup the kind of PowerShell window that doesn't appear for a millisecond # which is a millisecond too long if (-not ([Security.Principal.WindowsPrincipal][Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole] "Administrator")) { Write-Warning "Watch-DbaUpdate runs as a Scheduled Task which must be created. This will only happen once." Start-Process powershell -Verb runAs -ArgumentList Install-DbaWatchUpdate -Wait } try { Invoke-Command -ScriptBlock $script -ErrorAction Stop if ((Get-Location).Path -ne "$env:windir\system32") { $module = Get-Module -Name dbatools Write-Warning "Task created! A notification should appear momentarily. Here's something cute to look at in the interim." Show-Notification -Title "dbatools wants you" -Text "come hang out at dbatools.io/slack" } } catch { Write-Warning "Couldn't create scheduled task :(" return } # doublecheck if ($null -eq (Get-ScheduledTask -TaskName "dbatools version check" -ErrorAction SilentlyContinue)) { Write-Warning "Couldn't create scheduled task." } } else { Write-Output "Watch-DbaUpdate is already installed as a scheduled task called 'dbatools version check'" } } } |