---
title: "New-VBRFailbackSwitchingSchedule"
description: "This cmdlet defines the VBRFailbackSwitchingSchedule object. This object defines when the switch from replicas to production VMs must be performed."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrfailbackswitchingschedule.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Continuous Data Protection (CDP) > Two-Phase Failback > New-VBRFailbackSwitchingSchedule"
dateModified: "2026-08-19"
---

# New-VBRFailbackSwitchingSchedule

## Short Description
Defines the failback switching schedule.

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

## Syntax
```
New-VBRFailbackSwitchingSchedule [-Type <VBRFailbackSwitchingType>] [-ScheduledTime <DateTime>] [<CommonParameters>]
```

## Detailed Description
This cmdlet defines the `VBRFailbackSwitchingSchedule` object. This object defines when the switch from replicas to production VMs must be performed.

## 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">ScheduledTime</span></p>
        </td>
        <td>
          <p>For the scheduled type of the failback.</p><p>Specifies the date and time when Veeam Backup & Replication must perform failback from a CDP replica Vm to a production VM.</p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</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">Type</span></p>
        </td>
        <td>
          <p>Specifies a type of the failback schedule. You can set one of the following types:</p><ul><li><code>Manual</code>: Use this option if you want to switch CDP replica to production VMs manually once CDP replicas are ready.</li><li><code>Auto</code>: Use this option if you want to switch CDP replica to production VMs automatically once CDP replicas are ready.</li><li><code>Scheduled</code>: Use this option if you want to switch CDP replica to production VMs according to a specific schedule. Use the <code>ScheduledTime</code> parameter to specify the date and time for a scheduled failback.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>VBRFailbackSwitchingType</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
This cmdlet defines the `VBRFailbackSwitchingSchedule` object that defines the failback schedule settings.

## Examples

::: example
### Example 1. Defining Manual Failback Schedule

This command defines the manual failback schedule.

```
New-VBRFailbackSwitchingSchedule -Type Manual
```

:::

::: example
### Example 2. Defining Auto Failback Schedule

This command defines the auto failback schedule.

```
New-VBRFailbackSwitchingSchedule -Type Auto
```

:::

::: example
### Example 3. Defining Scheduled Failback

This command schedules the failback to run at 9.05.54 AM.

```
$date = Get-Date  -Year 2021 -Month 6 -Day 2 -Hour 9 -Minute 05 -Second 54
New-VBRFailbackSwitchingSchedule -Type Scheduled -ScheduledTime $date
```

Perform the following steps:

1. Run the [`Get-Date`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.1) cmdlet. Specify the `Year`, `Month`, `Day`, `Hour`, `Minute` and `Second` parameter values. Save the result to the `$date` variable.
2. Run the `New-VBRFailbackSwitchingSchedule` cmdlet. Specify the `Type` parameter value. Set the `$date` variable as the `ScheduledTime` parameter value.

:::

## Related Commands

[`Get-Date`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-date?view=powershell-7.1)