The New-CsOnlineSchedule cmdlet creates a new schedule for the Auto Attendant (AA) service. The AA service uses schedules to conditionally execute call flows when a specific schedule is in effect.
NOTES:
The type of the schedule cannot be altered after the schedule is created.
Currently, only two types of schedules can be created: WeeklyRecurrentSchedule or FixedSchedule.
The schedule types are mutually exclusive. So a weekly recurrent schedule cannot be a fixed schedule and vice versa.
For a weekly recurrent schedule, at least one day should have time ranges specified.
You can create a new time range by using New-CsOnlineTimeRange cmdlet.
A fixed schedule can be created without any date-time ranges. In this case, it would never be in effect.
For a fixed schedule, at most 10 date-time ranges can be specified.
You can create a new date-time range for a fixed schedule by using the New-CsOnlineDateTimeRange cmdlet.
The return type of this cmdlet composes a member for the underlying type/implementation. For example, in case of the weekly recurrent schedule, you can modify Monday's time ranges through the Schedule.WeeklyRecurrentSchedule.MondayHours property. Similarly, date-time ranges of a fixed schedule can be modified by using the Schedule.FixedSchedule.DateTimeRanges property.
This example creates a fixed schedule that is never active.
Parameters
-Complement
The Complement parameter indicates how the schedule is used.
When Complement is enabled, the schedule is used as the inverse of the provided configuration.
For example, if Complement is enabled and the schedule only contains time ranges of Monday to Friday from 9AM to 5PM, then the schedule is active at all times other than the specified time ranges.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-DateTimeRanges
List of date-time ranges for a fixed schedule. At most, 10 date-time ranges can be specified using this parameter.
Parameter properties
Type:
System.Collections.Generic.List
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
FixedSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-FixedSchedule
The FixedSchedule parameter indicates that a fixed schedule is to be created.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
FixedSchedule
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-FridayHours
List of time ranges for that day.
Parameter properties
Type:
System.Collections.Generic.List
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-MondayHours
List of time ranges for that day.
Parameter properties
Type:
System.Collections.Generic.List
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Name
The Name parameter represents a unique friendly name for the schedule.
Parameter properties
Type:
System.String
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-SaturdayHours
List of time ranges for that day.
Parameter properties
Type:
System.Collections.Generic.List
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-SundayHours
List of time ranges for that day.
Parameter properties
Type:
System.Collections.Generic.List
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-Tenant
This parameter is reserved for Microsoft internal use only.
Parameter properties
Type:
System.Guid
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
(All)
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-ThursdayHours
List of time ranges for that day.
Parameter properties
Type:
System.Collections.Generic.List
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-TuesdayHours
List of time ranges for that day.
Parameter properties
Type:
System.Collections.Generic.List
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WednesdayHours
List of time ranges for that day.
Parameter properties
Type:
System.Collections.Generic.List
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
False
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
-WeeklyRecurrentSchedule
The WeeklyRecurrentSchedule parameter indicates that a weekly recurrent schedule is to be created. This parameter is mandatory when a weekly recurrent schedule is to be created.
Parameter properties
Type:
SwitchParameter
Default value:
None
Supports wildcards:
False
DontShow:
False
Parameter sets
WeeklyRecurrentSchedule
Position:
Named
Mandatory:
True
Value from pipeline:
False
Value from pipeline by property name:
False
Value from remaining arguments:
False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable,
-InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable,
-ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see
about_CommonParameters.