Struggling to execute PowerShell commands in SqlServer Agent job of MS SQL Server 2012 R2 (Windows Server 2008R2, Windows 7 Prof)

I need to delete (.bak files older, than, say, 7 days in remote file share.

Before inserting the command into SqlServerAgent job, I tried to execute it from Windows command line:

  • using forfiles :
    forfiles /P "\\RemoteHostName\sharedFolderName" /s /m *.bak /D -7 /C "cmd /c del @path"

    gives the error:
    "ERROR: UNC paths (\machine\share) are not supported"

  • using Windows PowerShell:

    dir \\RemoteHostName\sharedFolderName |? {$_.CreationTime -lt (get-date).AddDays(-7)} | del

The latter deletes the required remote files when used from Windows PowerShell command prompt but when executed in/from an SqlServerAgent job - fails

The history of such SqlServerAgent jobs shows, quoting:

  • The job succeeded. The job was invoked by User domain\domainAccountName. The last step to run was step 1

    • Executed as user: localHostName\sqlbackup. The job script encountered the following errors. These errors did not stop script: A job step received an error at line in a PowerShellScript. The corresponding line is 'dir "\\RemoteHostName\sharedFolderName\" |? {$_.CreationTime -lt (get-date).AddDays(-7)} | del'. Correct the script and reschedule the job. The error information returned by PowerShell is: 'Cannot find path '\\RemoteHostName\sharedFolderName' because it does not exist. ' Process Exit Code 0. The step succeeded.

    enter image description here

Note the green check-marks on failed job and job steps

Again, zoomed-in the text output of the result:

enter image description here

Also, when executed this SqlServerAgent job step shows: "processing", then "Success"

enter image description here

though it is persistingly failing to delete required files.

The question(s):

  1. How to make the job and step, containing errors, to show "Failed" instead of of "Succeeded"?
  2. Why does the purging of older files using Windows PowerShell commands succeedes from command line prompt and fails from within SqlServerAgent job&step?

    2a. How succeed with removing of older remote files on schedule from SQL Server 2012?

I am using SQL Server Agent Job proxy according to this answer using local Windows user accounts on remote/target and local/source hosts with the same/equal names sqlbackup and the passwords

The same story with scheduling in Windows Task Scheduler - the job and steps are "succeeding" without deleting anything though copying to remote location (out of description here) by previous steps are successful. And I am interested to centralize all in SQL Server SqlServerAgent job (but not outside)


5 Answers 5


In order to make PowerShell errors cause a SQL Agent step to fail you have to make an adjustment to the $erroractionpreference setting. By default this value is set to Continue so the steps will show successful because no error is raised up for SQL Server Agent to detect an issue in the actual PowerShell command occurred.

You can put this at the top of your script that should fix that: $erroractionpreference="stop". This will allow the error PowerShell is returning to trickle up to SQL Server Agent process.


Forfiles doesn't work with UNC. The trick is to map the shared UNC using pushd. This maps and entered a temporarily drive. Popd will

pushd \RemoteHostName\sharedFolderName forfiles /P "\RemoteHostName\sharedFolderName" /s /m *.bak /D -7 /C "cmd /c del @path" popd


Use a domain account for running the SQL Server Agent. Give that account rights modify rights on the network share with the files you want to delete.


I have achieved this(How to delete the remote files older than N days on schedule from SQL Server 2012 (with SqlServerAgent job).

I have been running backups of SSAS databases, and needed to delete the old backup files, on a different server.

Please see run-a-powershell-script-on-a-different-server-from-inside-a-sql-server-job


Create a maintenance plan for deleting backups from folder having age greater than N days

Create Maintenance Cleanup Task > Select connection type as a User having sufficient rights(sysadmin user credentials) > Select the folder location containing backups > select the days or weeks till which you want the backups > OK

Now schedule this plan on daily/weekly basis.....

T-SQL created by maintenance plan is

EXECUTE master.dbo.xp_delete_file 0,N'BACKUP FOLDER LOCATION',N'bak',N'DATE FOR N DAYS T TIME ',1

But above script doesn't work properly if executed in query window, So use Maintenance plan.......

  • This does not work, unless I misunderstood it. How exactly in the maintenance plan? do you have an example of it working? Aug 12, 2015 at 15:37

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.