Skip to main content

Create a Scheduled Job that Deletes Itself

By
In last week’s PowerShell class, we had a question about not only running a scheduled job, but how to unregister it after it finishes.  Good question.  The answer is actually very simple.
The code below is a very simple job.  The problem with it is that after it executes, it will stay in memory until you unregister it.

$Trigger = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(1)

Register-ScheduledJob -Trigger $Trigger `
                      -Name "Test1" `
                      -ScriptBlock {Get-CimInstance -ClassName Win32_Bios}


In the Task Scheduler, we can see that the job completed, but it still in memory.


The cmdlet Unregister-ScheduledJob must be run to remove this object from memory.

PS C:\> Unregister-ScheduledJob -Name Test1

Now we will re-code the script to automatically remove the job after it completes.

$Trigger = New-ScheduledTaskTrigger -Once -At (Get-Date).AddMinutes(1)

Register-ScheduledJob -Trigger $Trigger `
                      -Name "Test1" `
                      -ScriptBlock {
                        Get-CimInstance -ClassName Win32_Bios
                        Unregister-ScheduledJob -Name "Test1"
                        }

Notice that the final cmdlet in the script block is Unregister-ScheduledJob.  This removal will take effect immediately in the Task Scheduler once the job completes.  If you are still in the same PowerShell session as the one you used to create the job, you will see the following error for a few minutes after the job is unregistered.

PS C:\> Get-ScheduledJob
Get-ScheduledJob : Cannot get the Test1 scheduled job because it is corrupted or in an irresolvable state. Because it cannot run,
Windows PowerShell has deleted Test1 and its results from the computer. To recreate the scheduled job, use the Register-ScheduledJob
cmdlet. For more information about corrupted scheduled jobs, see about_Scheduled_Jobs_Troubleshooting.
At line:1 char:1
+ Get-ScheduledJob
+ ~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidOperation: (:) [Get-ScheduledJob], RuntimeException
    + FullyQualifiedErrorId : CantLoadScheduledJobDefinitionFromStore,Microsoft.PowerShell.ScheduledJob.GetScheduledJobCommand

Again this error will correct itself shortly.

This method is only appropriate if you do not intent on recovering data from the script later on.  One of the benefits of a scheduled job is that the objects returned are serialized and written to disk for you to consume later.  If you un-register the job, that stored data is removed from this.  For this reason, you should ether explicitly commit the objects to disk before the Unregister-Scheduled job cmdlet is executed or only use this procedure for scripts that perform actions.  In any case, I would consider a little extra code to at least email you to let you know if the task was successful or not.



Labels:

Comments

Post a Comment

Popular posts from this blog

Sticky Key problem between Windows Server 2012 and LogMeIn

By
This week I instructed my first class using Windows Server 2012 accessed via LogMeIn and discovered a Sticky Key problem every time you press the Shift key. Here is my solution to resolve this.  First off, in the Preferences of LogMeIn for the connection to the Windows Server, click General . Change the Keyboard and mouse priority to Host side user and click Apply at the bottom. On the Windows 2012 server, open the Control Panel – Ease of Access – Change how your keyboard works . Uncheck Turn on Sticky Keys . Click Set up Sticky Keys . Uncheck Turn on Sticky Keys when SHIFT is pressed five times . Click OK twice. If you are using Windows Server 2012 as a Hyper-V host, you will need to redo the Easy of Use settings on each guest operating system in order to avoid the Sticky Key Problem. Updated Information: March 20, 2013 If you continue to have problems, Uncheck Turn on Filter Keys .
6 comments
Read more

Where did a User’s Account Get Locked Out?

By
Updated: May 15, 2015 When this article was originally published, two extra carriage returns were add causing the code to malfunction.  The code below is correct.   My client for this week’s PowerShell class had a really interesting question. They needed to know where an account is being locked out at. OK, interesting. Apparently users hop around clients and forget to log off, leading to eventual lock out of their accounts. The accounts can be unlocked, but are then relocked after Active Directory replication. This problem is solved in two parts. The first one is to modify the event auditing on the network. The second part is resolved with PowerShell. The first part involves creating a group policy that will encompass your Domain Controllers. In this GPO, make these changes. Expand Computer Configuration \ Policies \ Windows Settings \ Security Settings \ Advanced Audit Policy Configuration \ Audit Policies \ Account Management Double click User Account Management C...
18 comments
Read more

Backup and Restore AD LDS with DSDBUTIL.exe

By
Active Directory Lightweight Directory Services allow you to create a directory service that allows applications to have access to user accounts, groups, and authentication similar to Active Directory Domain Services.  The big advantage here is that the schema of the directory service will not be bound by the rules of an Active Directory database.  Exchange 2007/2010, for example, use an instance of AD LDS on the Edge Transport Server to provide for user authentication from the internet.  Because your Active Directory database is not exposed to the internet, this is more secure. Applications will handle most of the dirty work should they require AD LDS.  You may want to make sure the database is being backed up and also have a restore plan in place.  Should the database become corrupt, the application that uses that database will fail.  This document will walk you through backing up and restoring an instance of AD LDS using the dsdbutil.exe command. Fi...
6 comments
Read more