New-BESchedule Help

Synopsis

Creates a new Backup Exec schedule.

Syntax

New-BESchedule [-WeeklyEvery] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday} -StartingAt [<DateTime>] [-Every [<Int32>]] [<CommonParameters>]

New-BESchedule [-RunNow] [<SwitchParameter>] [<CommonParameters>]

New-BESchedule [-RunOnce] [<SwitchParameter>] -StartingAt [<DateTime>] [<CommonParameters>]

New-BESchedule [-Minutely] [<SwitchParameter>] -StartingAt [<DateTime>] [-Every [<Int32>]] [<CommonParameters>]

New-BESchedule [-Hourly] [<SwitchParameter>] -StartingAt [<DateTime>] [-Every [<Int32>]] [<CommonParameters>]

New-BESchedule [-Daily] [<SwitchParameter>] -StartingAt [<DateTime>] [-Every [<Int32>]] [<CommonParameters>]

New-BESchedule [-Weekdays] [<SwitchParameter>] -StartingAt [<DateTime>] [<CommonParameters>]

New-BESchedule [-MonthlyOnDayNumber] [<Int32>] -StartingAt [<DateTime>] [-Every [<Int32>]] [<CommonParameters>]

New-BESchedule [-MonthlyEvery] {First | Second | Third | Fourth | Last} [-Day] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday | Weekday | WeekendDay | Day} -StartingAt [<DateTime>] [-Every [<Int32>]] [<CommonParameters>]

New-BESchedule [-YearlyOnMonthDayNumber] [<Int32>] [-Month] {January | February | March | April | May | June | July | August | September | October | November | December} -StartingAt [<DateTime>] [-Every [<Int32>]] [<CommonParameters>]

New-BESchedule [-YearlyEvery] {First | Second | Third | Fourth | Last} [-Day] {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday | Weekday | WeekendDay | Day} [-Month] {January | February | March | April | May | June | July | August | September | October | November | December} -StartingAt [<DateTime>] [-Every [<Int32>]] [<CommonParameters>]

Description

Creates a new Backup Exec schedule.

The output of New-BESchedule is used for the Schedule parameter of the following commands:
Add-BEConvertToVirtualStageBackupTask
Add-BEDifferentialBackupTask
Add-BEDuplicateStageBackupTask
Add-BEFullBackupTask
Add-BEIncrementalBackupTask
Set-BEDifferentialBackupTask
Set-BEDuplicateStageBackupTask
Set-BEFullBackupTask
Set-BEIncrementalBackupTask
Submit-BECleanJob
Submit-BEEjectMediaJob
Submit-BEExportExpiredMediaJob
Submit-BEExportMediaJob
Submit-BEImportMediaJob
Submit-BEInventoryJob

Parameters

-RunNow <SwitchParameter>

Runs the job immediately.

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-RunOnce <SwitchParameter>

Runs the job immediately without a recurring schedule.

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-Minutely <SwitchParameter>

Schedules a recurrence pattern that is based on minutes.

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-Hourly <SwitchParameter>

Schedules a recurrence pattern that is based on hours.

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-Daily <SwitchParameter>

Schedules a recurrence pattern that is based on days.

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-Weekdays <SwitchParameter>

Schedules recurrence pattern that is based on weekdays.

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-WeeklyEvery

Schedules a recurrence pattern that is based on specific days of the week.

The valid values are:
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-MonthlyOnDayNumber <Int32>

Schedules a recurrence pattern that is based on a specific day of the month.

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-MonthlyEvery

Schedules a recurrence pattern that is based on a specific days of the month.

The valid values are:
First
Second
Third
Fourth
Last

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-YearlyOnMonthDayNumber <Int32>

Schedules a recurrence pattern that is yearly on a specific day of the month.

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-YearlyEvery

Schedules a recurrence pattern that is yearly based on a specific days of the month.

The valid values are:
First
Second
Third
Fourth
Last

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-Month

Specifies a month.

The valid values are:
January
February
March
April
May
June
July
August
September
October
November
December

Required	true
Position	0
Accepts pipeline input	false
Accepts wildcard characters	false

-Day

Specifies a day.

The valid values are:
Sunday
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Weekday
WeekendDay
Day

Required	true
Position	1
Accepts pipeline input	false
Accepts wildcard characters	false

-Every <Int32>

Specifies how often to repeat the schedule. The default value is 1.

Required	false
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

-StartingAt <DateTime>

Specifies when the schedule starts.

Required	true
Position	Named
Accepts pipeline input	false
Accepts wildcard characters	false

For more information about common parameters, type "Get-Help about_commonparameters".

Input Type

None

This cmdlet does not accept any input.

Return Value

BackupExec.Management.CLI.BESchedule

An object that represents the specified schedule.

Examples

Example 1

C:\PS> New-BESchedule -RunNow

This command creates a schedule that will run a job once and starts immediately.

Example 2

C:\PS> New-BESchedule -RunOnce -StartingAt 10PM

This command creates a schedule that will run a job once starting today at 10PM.

Example 3

C:\PS> New-BESchedule -Minutely -Every 5 -StartingAt 10PM

This command creates a schedule that will run a job every five minutes starting today at 10PM.

Example 4

C:\PS> New-BESchedule -Hourly -StartingAt 10PM

This command creates a schedule that will run a job every hour starting today at 10PM.

Example 5

C:\PS> New-BESchedule -Daily -StartingAt 10PM

This command creates a schedule that will run a job every day starting today at 10PM.

Example 6

C:\PS> New-BESchedule -Weekdays -StartingAt 10PM

This command creates a schedule that will run a job every weekday starting today at 10PM.

Example 7

C:\PS> New-BESchedule -WeeklyEvery Monday,Wednesday,Friday -StartingAt 10PM

This command creates a schedule that will run a job every Monday, Wednesday and Friday starting today at 10PM.

Example 8

C:\PS> New-BESchedule -MonthlyOnDayNumber 10 -StartingAt "1/1/2012 10PM"

This command creates a schedule that will run a job on the 10th of every month at 10PM effective on January 1, 2012.

Example 9

C:\PS> New-BESchedule -MonthlyEvery Last Friday -StartingAt "1/1/2012 10PM"

This command creates a schedule that will run a job every last Friday of the month at 10PM effective on January 1, 2012.

Example 10

C:\PS> New-BESchedule -YearlyOnMonthDayNumber 1 January -StartingAt "1/1/2012 10PM"

This command creates a schedule that will run a job every year on the 10th of January at 10PM effective on January 1, 2012.

Example 11

C:\PS> New-BESchedule -YearlyEvery First Monday March -StartingAt "1/1/2012 10PM"

This command creates a schedule that will run a job every year on the first Monday of March at 10PM effective on January 1, 2012.