---
title: "Set-VBOCopyJobSchedulePolicy"
description: "This cmdlet modifies the backup copy job schedule settings. To modify settings, you need to enter the necessary parameters with new values. The parameters that you omit will remain unchanged."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/set-vbocopyjobschedulepolicy.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Copy > Backup Copy Job Schedule > Set-VBOCopyJobSchedulePolicy"
dateModified: "2026-08-21"
---

# Set-VBOCopyJobSchedulePolicy

## Short Description
Modifies the backup copy job schedule settings.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Immediate (Default)</code></p>

```
Set-VBOCopyJobSchedulePolicy -Policy <VBOCopyJobSchedulePolicy> [-Type <VBOCopyJobFrequencyType>]
 [-BackupWindowSettings <VBOBackupWindowSettings>] [-EnableBackupWindow] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Periodically</code></p>

```
Set-VBOCopyJobSchedulePolicy -Policy <VBOCopyJobSchedulePolicy> [-Type <VBOCopyJobFrequencyType>]
 [-PeriodicallyEvery <VBOPeriodicInterval>] [-BackupWindowSettings <VBOBackupWindowSettings>]
 [-EnableBackupWindow] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Daily</code></p>

```
Set-VBOCopyJobSchedulePolicy -Policy <VBOCopyJobSchedulePolicy> [-Type <VBOCopyJobFrequencyType>]
 [-DailyTime <TimeSpan>] [-DailyType <VBODailyType>] [-BackupWindowSettings <VBOBackupWindowSettings>]
 [-EnableBackupWindow] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet modifies the backup copy job schedule settings. To modify settings, you need to enter the necessary parameters 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">BackupWindowSettings</span></p>
        </td>
        <td>
          <p>Specifies the backup window within which the backup copy job must be completed.</p><p>Accepts the <a href="vbobackupwindowsettings.md"><code>VBOBackupWindowSettings</code></a> object.</p><p>To create this object, run the <a href="new-vbobackupwindowsettings.md"><code>New-VBOBackupWindowSettings</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbobackupwindowsettings.md"><code>VBOBackupWindowSettings</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">DailyTime</span></p>
        </td>
        <td>
          <p>Specifies the time to start the backup copy job.</p>
        </td>
        <td style="width:10%;">
          <p><code>TimeSpan</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">DailyType</span></p>
        </td>
        <td>
          <p>Specifies the days when the backup copy job will run:</p><ul><li><code>Everyday</code></li><li><code>Weekends</code></li><li><code>Workdays</code></li><li><code>Monday</code></li><li><code>Tuesday</code></li><li><code>Wednesday</code></li><li><code>Thursday</code></li><li><code>Friday</code></li><li><code>Saturday</code></li><li><code>Sunday</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBODailyType</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">EnableBackupWindow</span></p>
        </td>
        <td>
          <p>Defines that the job run will be terminated if it exceeds the allowed backup window.</p><p>Default: <em>False</em></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">PeriodicallyEvery</span></p>
        </td>
        <td>
          <p>Specifies the time interval between the job runs:</p><ul><li><code>Minutes5</code></li><li><code>Minutes10</code></li><li><code>Minutes15</code></li><li><code>Minutes30</code></li><li><code>Hours1</code></li><li><code>Hours2</code></li><li><code>Hours4</code></li><li><code>Hours8</code></li><li><code>Hours12</code></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBOPeriodicInterval</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">Policy</span></p>
        </td>
        <td>
          <p>Specifies the backup copy job schedule whose settings you want to modify.</p><p>Accepts the <a href="vbocopyjobschedulepolicy.md"><code>VBOCopyJobSchedulePolicy</code></a> object.</p><p>To create this object, run the <a href="new-vbocopyjobschedulepolicy.md"><code>New-VBOCopyJobSchedulePolicy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbocopyjobschedulepolicy.md"><code>VBOCopyJobSchedulePolicy</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">Type</span></p>
        </td>
        <td>
          <p>Specifies a type of the backup copy job schedule:</p><ul><li><p><code>Immediate</code>: runs the backup copy job right after the latest restore point appears in the source backup repository.</p><p>During the first run of the backup copy job, Veeam Backup for Microsoft 365 copies the latest restore point created by the source backup job (backup job for which you create a backup copy job). During next runs — each subsequent restore point.</p></li><li><p><code>Daily</code>: runs the backup copy job on specific days at the specified hours.</p></li><li><p><code>Periodically</code>: runs the backup copy job repeatedly throughout a day with a specific time interval.</p></li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBOCopyJobFrequencyType</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 the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Output Object
The cmdlet returns the [`VBOCopyJobSchedulePolicy`](vbocopyjobschedulepolicy.md) object that contains the backup copy job schedule settings.

## Examples

::: example
### Example 1: Changing Backup Copy Job Schedule Type to Immediate

This example shows how to modify the settings of a backup copy job schedule:

- Veeam Backup for Microsoft 365 will now run a backup copy job immediately.
- A backup copy job will now stop if its processing exceeds the allowed backup window.

```
$copyjob = Get-VBOCopyJob -Id 8b6b539e-15cc-4ed6-bd1d-b8c7c918f413
$schedule = $copyjob.schedulepolicy
$bwindow = New-VBOBackupWindowSettings -FromDay Monday -FromHour 8 -ToDay Sunday -ToHour 17 -Enabled:$true
Set-VBOCopyJobSchedulePolicy -Policy $schedule -Type Immediate -EnableBackupWindow -BackupWindowSettings $bwindow
Set-VBOCopyJob -Job $copyjob -SchedulePolicy $schedule
```

Perform the following steps:

1. Run the [`Get-VBOCopyJob`](get-vbocopyjob.md) cmdlet to get a backup copy job whose schedule settings you want to modify. Specify the `Id` parameter value. Save the result to the `$copyjob` variable.
2. Get the job schedule settings that you want to modify. Use the `SchedulePolicy` property of the [`VBOCopyJob`](vbocopyjob.md) object saved to the `$copyjob` variable. Save the result to the `$schedule` variable.
3. Run the [`New-VBOBackupWindowSettings`](new-vbobackupwindowsettings.md) cmdlet to create a backup window within which the backup copy job is allowed to run. Save the result to the `$bwindow` variable.
4. Run the `Set-VBOCopyJobSchedulePolicy` cmdlet with the `$schedule` and `$bwindow` variables to modify the backup copy job schedule settings.
5. Run the [`Set-VBOCopyJob`](set-vbocopyjob.md) cmdlet with the `$copyjob` and `$schedule` variables to apply the schedule with the new settings to the backup copy job.

:::

::: example
### Example 2: Changing Backup Copy Job Schedule Type from Daily to Periodically

This example shows how to change the type of a backup copy job schedule from `Daily` to `Periodically`. A backup copy job per this schedule will now run every 4 hours.

```
$copyjob = Get-VBOCopyJob -Id 8b6b539e-15cc-4ed6-bd1d-b8c7c918f413
$pschedule = $copyjob.schedulepolicy
Set-VBOCopyJobSchedulePolicy -Policy $pschedule -Type Periodically -PeriodicallyEvery Hours4
Set-VBOCopyJob -Job $copyjob -SchedulePolicy $pschedule
```

Perform the following steps:

1. Run the [`Get-VBOCopyJob`](get-vbocopyjob.md) cmdlet to get a backup copy job whose schedule settings you want to modify. Specify the `Id` parameter value. Save the result to the `$copyjob` variable.
2. Get the job schedule settings that you want to modify. Use the `SchedulePolicy` property of the [`VBOCopyJob`](vbocopyjob.md) object saved to the `$copyjob` variable. Save the result to the `$pschedule` variable.
3. Run the `Set-VBOCopyJobSchedulePolicy` cmdlet with the `$pschedule` variable to modify the backup copy job schedule settings.
4. Run the [`Set-VBOCopyJob`](set-vbocopyjob.md) cmdlet with the `$copyjob` and `$pschedule` variables to apply the schedule with the new settings to the backup copy job.

:::

::: example
### Example 3: Changing Backup Copy Job Schedule Type from Periodically to Daily

This example shows how to change the type of a backup copy job schedule from `Periodically` to `Daily`. A backup copy job per this schedule will now run on workdays at 10:00:00.

```
$copyjob = Get-VBOCopyJob -Id 8b6b539e-15cc-4ed6-bd1d-b8c7c918f413
$dschedule = $copyjob.schedulepolicy
Set-VBOCopyJobSchedulePolicy -Policy $dschedule -Type Daily -DailyType Workdays -DailyTime 10:00:00
Set-VBOCopyJob -Job $copyjob -SchedulePolicy $dschedule
```

Perform the following steps:

1. Run the [`Get-VBOCopyJob`](get-vbocopyjob.md) cmdlet to get a backup copy job whose schedule settings you want to modify. Specify the `Id` parameter value. Save the result to the `$copyjob` variable.
2. Get the job schedule settings that you want to modify. Use the `SchedulePolicy` property of the [`VBOCopyJob`](vbocopyjob.md) object saved to the `$copyjob` variable. Save the result to the `$dschedule` variable.
3. Run the `Set-VBOCopyJobSchedulePolicy` cmdlet with the `$dschedule` variable to modify the backup copy job schedule settings.
4. Run the [`Set-VBOCopyJob`](set-vbocopyjob.md) cmdlet with the `$copyjob` and `$dschedule` variablesto apply the schedule with the new settings to the backup copy job.

:::

## Related Commands

- [`New-VBOCopyJobSchedulePolicy`](new-vbocopyjobschedulepolicy.md)
- [`Get-VBOCopyJob`](get-vbocopyjob.md)
- [`New-VBOBackupWindowSettings`](new-vbobackupwindowsettings.md)
- [`Set-VBOCopyJob`](set-vbocopyjob.md)