---
title: "Set-VBRUnixScheduleOptions"
description: "This cmdlet modifies schedule for Unix jobs, created with Veeam Agent for Oracle Solaris or Veeam Agent for IBM AIX. To modify settings, specify new values for the necessary parameters."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/set-vbrunixscheduleoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Veeam Agent Management > Working with Veeam Agent Backup Jobs and Policies > Veeam Agent Job Schedule > Set-VBRUnixScheduleOptions"
dateModified: "2026-08-19"
---

# Set-VBRUnixScheduleOptions

## Short Description
Modifies schedule for Unix jobs.

**Product Edition**: Standard, Enterprise, Enterprise Plus, Veeam Universal License

## Syntax
```
Set-VBRUnixScheduleOptions -Options <VBRUnixScheduleOptions> [-Type <VBRServerScheduleType>]
 [-DailyOptions <VBRDailyOptions>] [-MonthlyOptions <VBRMonthlyOptions>]
 [-PeriodicallyOptions <VBRPeriodicallyOptions>] [-EnableRetry] [-RetryCount <Int32>] [-RetryTimeout <Int32>]
 [-EnableBackupTerminationWindow] [-TerminationWindow <VBRBackupWindowOptions>] [<CommonParameters>]
```

## Detailed Description
This cmdlet modifies schedule for Unix jobs, created with Veeam Agent for Oracle Solaris or Veeam Agent for IBM AIX.

::: note

To modify settings, specify new values for the necessary parameters. The cmdlet will overwrite the previous parameter values with new values. The parameters that you omit will remain unchanged.

:::

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">DailyOptions</span></p>
        </td>
        <td>
          <p>For daily schedule.</p><p>Specifies daily schedule settings. The cmdlet will create the server schedule with these settings.</p><p>Accepts the <a href="vbrdailyoptions.md"><code>VBRDailyOptions</code></a> object. To get this object, run the <a href="new-vbrdailyoptions.md"><code>New-VBRDailyOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrdailyoptions.md"><code>VBRDailyOptions</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">EnableBackupTerminationWindow</span></p>
        </td>
        <td>
          <p>Enables the option to stop the Veeam Agent backup job if it exceeds the backup window.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">EnableRetry</span></p>
        </td>
        <td>
          <p>Enables the option to run a Unix job again in case it fails.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">MonthlyOptions</span></p>
        </td>
        <td>
          <p>For monthly schedule.</p><p>Specifies monthly schedule settings. The cmdlet will create the server schedule with these settings.</p><p>Accepts the <a href="vbrmonthlyoptions.md"><code>VBRMonthlyOptions</code></a> object. To get this object, run the <a href="new-vbrmonthlyoptions.md"><code>New-VBRMonthlyOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrmonthlyoptions.md"><code>VBRMonthlyOptions</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Options</span></p>
        </td>
        <td>
          <p>Specifies the Unix jobs schedule settings that you want to modify.</p><p>Accepts the <a href="vbrunixscheduleoptions.md"><code>VBRUnixScheduleOptions</code></a> object. To get this object, run the <a href="new-vbrunixscheduleoptions.md"><code>New-VBRUnixScheduleOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrunixscheduleoptions.md"><code>VBRUnixScheduleOptions</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PeriodicallyOptions</span></p>
        </td>
        <td>
          <p>For periodical run.</p><p>Specifies periodical schedule settings. The cmdlet will create the server schedule with these settings.</p><p>Accepts the <a href="vbrperiodicallyoptions.md"><code>VBRPeriodicallyOptions</code></a> object. To get this object, run the <a href="new-vbrperiodicallyoptions.md"><code>New-VBRPeriodicallyOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrperiodicallyoptions.md"><code>VBRPeriodicallyOptions</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RetryCount</span></p>
        </td>
        <td>
          <p>For the <code>EnableRetry</code> parameter.</p><p>Specifies the number of attempts to run the failed Unix backup job.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RetryTimeout</span></p>
        </td>
        <td>
          <p>For the <code>EnableRetry</code> parameter.</p><p>Specifies a timeout interval between retry attempts in minutes.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">TerminationWindow</span></p>
        </td>
        <td>
          <p>Specifies the time interval within which the backup job must complete.</p><p>Accepts the <a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a> object. To create this object, run the <a href="new-vbrbackupwindowoptions.md"><code>New-VBRBackupWindowOptions</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrbackupwindowoptions.md"><code>VBRBackupWindowOptions</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Type</span></p>
        </td>
        <td>
          <p>Specifies the Unix schedule type.</p><ul><li><p><code>Daily</code>: use this option to run the job at a specific time daily.</p></li><li><p><code>Monthly</code>: use this option to run the job once a month on specific days.</p></li><li><p><code>Periodically</code>: use this option to run the job repeatedly throughout a day with a specific time interval.</p></li><li><p><code>AfterJob</code>: use this option to create a chain of jobs. Veeam Backup & Replication will start the Unix job after the other backup job.</p><p><strong>Note</strong>: The <code>AfterJob</code> option does not work for backup policy.</p></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRServerScheduleType</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the [`VBRUnixScheduleOptions`](vbrunixscheduleoptions.md) object that defines schedule for Unix jobs.

## Examples

::: example
### Modifying Schedule for Unix Jobs

This example shows how to modify schedule for Unix jobs. The example also restricts the job to a backup window from 20:00 to 22:59, Monday to Friday.

```
$daily = New-VBRDailyOptions -DayOfWeek Friday -Period 7:00
$unixschedule = New-VBRUnixScheduleOptions -Type Daily -DailyOptions $daily
$newdaily = New-VBRDailyOptions -DayOfWeek Wednesday -Period 7:00
$window = New-VBRBackupWindowOptions -FromDay Monday -ToDay Friday -FromHour 20 -ToHour 22 -Enabled
Set-VBRUnixScheduleOptions -Options $unixschedule -DailyOptions $newdaily -EnableBackupTerminationWindow -TerminationWindow $window
```

Perform the following steps:

1. Run the [`New-VBRDailyOptions`](new-vbrdailyoptions.md) cmdlet. Specify the `DayOfWeek` and `Period` parameter values. Save the result to the `$daily` variable.
2. Run the [`New-VBRUnixScheduleOptions`](new-vbrunixscheduleoptions.md) cmdlet. Set the `Daily` value as the `Type` parameter value. Set the `$daily` variable as the `DailyOptions` parameter value. Save the result to the `$unixschedule` variable.
3. Run the [`New-VBRDailyOptions`](new-vbrdailyoptions.md) cmdlet. Specify the `DayOfWeek` and `Period` parameter values. Save the result to the `$newdaily` variable.
4. Run the [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md) cmdlet. Specify the `FromDay`, `ToDay`, `FromHour` and `ToHour` parameter values. Provide the `Enabled` parameter. Save the result to the `$window` variable.
5. Run the `Set-VBRUnixScheduleOptions` cmdlet. Set the `$unixschedule` variable as the `Options` parameter value. Set the `$newdaily` variable as the `DailyOptions` parameter value. Provide the `EnableBackupTerminationWindow` parameter. Set the `$window` variable as the `TerminationWindow` parameter value.

:::

## Related Commands

- [`New-VBRBackupWindowOptions`](new-vbrbackupwindowoptions.md)
- [`New-VBRDailyOptions`](new-vbrdailyoptions.md)
- [`New-VBRUnixScheduleOptions`](new-vbrunixscheduleoptions.md)