set backup window for backup copy job

[AlexL]

Just been struggling a while to set a backup window for a backup copy job. This might help anyone else having the issues with this.

In the documentation (https://helpcenter.veeam.com/docs/vbr/p ... pyjob.html), the text for -Anytime is either wrong or misleading at best.
It seems to be a Boolean not a Switch as described in the parameters table. With a switch parameter you would assume that not using it will do A and using it will do B.

This does not seem to be the case here. You must use explicitly -Anytime:$False to enable the backup window you can supply with -BackupWindowOptions

So, you would expect this (as the example suggest):

$job = Get-VBRBackupCopyJob -Name "Copy Job05"
$windowoptions = New-VBRBackupWindowOptions -FromDay Monday -FromHour 08 -ToDay Friday -ToHour 20
Set-VBRBackupCopyJob -Job $job -BackupWindowOptions $windowoptions

The above lines are NOT fully functional, you ALSO need to do -Anytime:$False, so a complete example would be:

$job = Get-VBRBackupCopyJob -Name "Copy Job05"
$windowoptions = New-VBRBackupWindowOptions -FromDay Monday -FromHour 08 -ToDay Friday -ToHour 20
Set-VBRBackupCopyJob -Job $job -Anytime:$False
Set-VBRBackupCopyJob -Job $job -BackupWindowOptions $windowoptions

And unfortunately, you cannot use -Anytime:$False together with -BackupWindowOptions.

I believe this to be a bug, expected behavior would be:

Set-VBRBackupCopyJob -Job $job -Anytime <- disable backup window, so the job runs 24/7
Set-VBRBackupCopyJob -Job $job -BackupWindowOptions $windowoptions <- enable & set the backup window

As explained above, you can work around this bug but then the documentation should be clearer as I suggested in my example.

Regards,
Alex

[david.domask]

Hi Alex,

I see the same behavior and I cannot explain why it should be this way. Give me some time to discuss internally and will update when I have more information.

[david.domask]

@AlexL,

Behavior is confirmed intentional - the design is meant to let you disable the AnyTime option (as shown in the UI) and start using Backup Windows, or to disable backup windows and let the job run AnyTime.

I will work with the TechWriters to update the User Guide to be more clear on the intended workflow.

[AlexL]

While I understand this from a programmers perspective, it is not really intuitive from a user perspective.
But clearer documantation would help a lot.