Remove-ScheduledRestartComputerJob.ps1
|
<#
.Synopsis Remove scheduled Restart-Computer job and script. .DESCRIPTION Remove scheduled Restart-Computer job and script. .NOTES Created by: Jason Wasser @wasserja Modified: 6/2/2017 .PARAMETER Name The full name of the scheduled restart computer job if known. .PARAMETER JobNamePrefix The prefix of the scheduled restart computer job exists to differentiate the restart jobs from other PowerShell scheduled jobs. .PARAMETER ScriptFilePath The path to the script file that is executed by the scheduled restart computer job. .EXAMPLE Remove-ScheduledRestartComputerJob .EXAMPLE Remove-ScheduledRestartComputerJob -Name MyJob -JobNamePrefix 'RestartComputerJob' -ScriptFilePath 'C:\Scripts' #> #Requires -RunAsAdministrator #Requires -Modules PSScheduledJob function Remove-ScheduledRestartComputerJob { [CmdletBinding(SupportsShouldProcess=$True)] Param ( [Parameter(Mandatory=$true, ValueFromPipelineByPropertyName=$true)] [string]$Name, [string]$JobNamePrefix = 'RestartComputer-', [ValidateScript({ Test-Path $_ -PathType Container })] [string]$ScriptFilePath="C:\Temp\" ) Begin { } Process { Write-Verbose -Message 'Gathering Restart jobs to remove.' $RestartJobs = Get-ScheduledRestartComputerJob | Where-Object -FilterScript {$_.Name -like $Name} foreach ($RestartJob in $RestartJobs) { if ($RestartJob.JobStatus -eq 'Running') { Write-Warning -Message "RestartJob $($RestartJob.Name) is currently $($RestartJob.JobStatus). Skipping removal of job." } else { Write-Verbose -Message "RestartJob $($RestartJob.Name) is currently $($RestartJob.JobStatus). Proceeding to remove job." Write-Verbose -Message "Unregistering RestartJob $($RestartJob.Name)" Unregister-ScheduledJob -Id $RestartJob.Id if (Test-Path -Path $RestartJob.JobScript) { Write-Verbose -Message "Deleting RestartJob Script $($RestartJob.JobScript)" Remove-Item $RestartJob.JobScript } } } } End { } } |