Platform: WindowsProducts: Managed Backup (Agent)
Article ID: m2074Last Modified: 16-Oct-2024

New-MBSPlanSchedule


Returs MBS.Agent.Plan.Schedule object.


New-MBSPlanSchedule
		[-Once]
		[-At <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Daily]
		[-OccursFrom <TimeSpan>]
		[-OccursTo <TimeSpan>]
		[-OccursEvery <TimeSpan>]
		[-RepeatInterval <Int32>]
		[-RepeatStartDate <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Daily]
		[-At <DateTime>]
		[-RepeatInterval <Int32>]
		[-RepeatStartDate <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Weekly]
		[-DayOfWeek {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}]
		[-OccursFrom <TimeSpan>]
		[-OccursTo <TimeSpan>]
		[-OccursEvery <TimeSpan>]
		[-RepeatInterval <Int32>]
		[-RepeatStartDate <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Weekly]
		[-At <DateTime>]
		[-DayOfWeek {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}]
		[-RepeatInterval <Int32>]
		[-RepeatStartDate <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Monthly]
		[-DayOfWeek {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}]
		[-WeekNumber {First | Second | Third | Fourth | Penultimate | Last}]
		[-OccursFrom <TimeSpan>]
		[-OccursTo <TimeSpan>]
		[-OccursEvery <TimeSpan>]
		[-RepeatInterval <Int32>]
		[-RepeatStartDate <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Monthly]
		[-At <DateTime>]
		[-DayOfWeek {Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}]
		[-WeekNumber {First | Second | Third | Fourth | Penultimate | Last}]
		[-RepeatInterval <Int32>]
		[-RepeatStartDate <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Monthly]
		[-DayOfMonth <Int32>]
		[-OccursFrom <TimeSpan>]
		[-OccursTo <TimeSpan>]
		[-OccursEvery <TimeSpan>]
		[-RepeatInterval <Int32>]
		[-RepeatStartDate <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Monthly]
		[-At <DateTime>]
		[-DayOfMonth <Int32>]
		[-RepeatInterval <Int32>]
		[-RepeatStartDate <DateTime>]
		[<CommonParameters>]

New-MBSPlanSchedule
		[-Realtime]
		[<CommonParameters>]






Description

Creates MBS backup plan schedule object.


Examples

Example 1: Run once at 10:00

PS C:\> New-MBSPlanSchedule -Once -At 10:00

Example 2: Run daily at 10:00

PS C:\> New-MBSPlanSchedule -Daily -At 10:00

Example 3: Run every two days at 10:00 from today.

PS C:\> New-MBSPlanSchedule -Daily -At 10:00 -RepeatInterval 2 -RepeatStartDate (Get-Date)

Example 4: Run every Friday at 6 PM from today.

PS C:\> New-MBSPlanSchedule -Weekly -At "06:00 PM" -DayOfWeek Friday -RepeatInterval 1 -RepeatStartDate (Get-Date)

Example 5: Run every third month on trird day at 6 PM from today + 2 days.

PS C:\> New-MBSPlanSchedule -Monthly -At "18:00" -DayOfMonth 3 -RepeatInterval 3 -RepeatStartDate ((Get-Date)+2.)

Example 6: Run real-time.

PS C:\> New-MBSPlanSchedule -Realtime

Parameters

-Once

Run once

Type SwitchParameter
Required: false
Position: named
Default value: False
Accept pipeline input: false
Accept wildcard characters: false

-Daily

Run either daily at specific time or daily from/till specific time every specific min/hour

Type SwitchParameter
Required: false
Position: named
Default value: False
Accept pipeline input: false
Accept wildcard characters: false

-Weekly

Run weekly at specific time or weekly from/till specific time every specific min/hour

Type SwitchParameter
Required: false
Position: named
Default value: False
Accept pipeline input: false
Accept wildcard characters: false

-Monthly

Run monthly at specific time or monthly from/till specific time every specific min/hour

Type SwitchParameter
Required: false
Position: named
Default value: False
Accept pipeline input: false
Accept wildcard characters: false

-Realtime

Run real-time

Type SwitchParameter
Required: false
Position: named
Default value: False
Accept pipeline input: false
Accept wildcard characters: false

-At

Specify either datetime or time of schedule

Type DateTime
Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-DayOfMonth

Specify day for 'dayofmonth' schedule (1..31)

Type Int32
Required: false
Position: named
Default value: 0
Accept pipeline input: false
Accept wildcard characters: false

-DayOfWeek

Specify day(s) of week for weekly schedule or day of week for monthly schedule. Possible values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday

Type DayOfWeek[]
Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-WeekNumber

Specify number of week. Possible values: First, Second, Third, Fourth, Penultimate, Last

Type WeekNumber
Required: false
Position: named
Accepted values: First, Second, Third, Fourth, Penultimate, Last
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-OccursFrom

Specify daily recurring from value

Type TimeSpan
Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-OccursTo

Specify daily recurring till value

Type TimeSpan
Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-OccursEvery

Specify recurring period value. Possible values: 1-59 min, or 1-180 hour

Type TimeSpan
Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

-RepeatInterval

Specify repeat period value (days). Possible values: 1..31

Type Int32
Required: false
Position: named
Default value: 0
Accept pipeline input: false
Accept wildcard characters: false

-RepeatStartDate

Specify start date of repetitions

Type DateTime
Required: false
Position: named
Default value:
Accept pipeline input: false
Accept wildcard characters: false

CommonParameters

This cmdlet supports the common parameters: Verbose, Debug, ErrorAction, ErrorVariable, WarningAction, WarningVariable, OutBuffer, PipelineVariable, and OutVariable. For more information, see about_CommonParameters.

Inputs

None.

Outputs

MBS.Agent.Plan.BackupPlanCommonOption

Notes

Author: MSP360 Onboarding Team

https://git.cloudberrylab.com/egor.m/doc-help-mbs.git