Release candidate
...
Administration
Background tasks

Configuring Windows Task Scheduler

5min

Task Scheduler is a utility built into Windows that allows you to automatically run programs or scripts on a schedule or when specified conditions occur.

Passwerk version 7 and higher has a special script that is responsible for running background tasks:

PowerShell


It can be executed manually or set to run on a schedule using Windows Tasks Scheduler.

We recommend that you first test the script in manual mode. To do this, perform the following actions in PowerShell:

PowerShell


If the error indicates that there is no php.exe utility to run the background task, then the PHP directory should be added to the PATH environment variable.

Check the file C:\inetpub\wwwroot\passwork\var\log\tasks.log for errors.

Make sure that the user on whose behalf the script is executed has write permissions

Configuring Task Scheduler

Run PowerShell as Administrator:

  • Right-click on the Start icon in the lower left corner of the screen;
  • Select Windows PowerShell (Administrator) from the context menu.

Create a task in the Scheduler to run the script:

PowerShell


The following parameters should include details of the user on whose behalf the task will run:

  • -User — Username;
  • -Password — User password.

We recommend using the local Administrator account to avoid any problems with permissions.

Testing and troubleshooting

Open Passwork and log in as Administrator/Owner and click the Background Tasks tab.

If the configuration is correct, a message will be displayed that the scheduler is configured:

Document image


If you see a message that the scheduler is not configured, the execution errors are located in the log file C:\inetpub\wwwroot\passwork\var\log\tasks.log

If you need help solving the problem, you can send this file to Passwork technical support.