# New-RASSchedule ### NAME New-RASSchedule\
### SYNOPSIS Creates a new Schedule.\
### SYNTAX New-RASSchedule \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#SiteId)] *\*] -[Action](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Action) {Disable | Reboot | Startup | Shutdown} -[GuestName](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#GuestName) *\* -[GUID](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#GUID) *\* -[HostAzureID](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#HostAzureID) *\* -[ObjType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#ObjType) {RDS | VDI | AVD} -[PoolId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#PoolId) *\* -[TargetType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#TargetType) {Host | HostPool} \[-[CompleteIn](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#CompleteIn) *\*] \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Description) *\*] \[-[DurationInSecs](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#DurationInSecs) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Enabled) *\*] \[-[EnableDrainMode](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#EnableDrainMode) *\*] \[-[EnforceScheduleInactiveHost](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#EnforceScheduleInactiveHost) *\*] \[-[ForceServerRebootAfter](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#ForceServerRebootAfter) *\*] \[-[MembersToStart](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#MembersToStart) *\*] \[-[OnDisable](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#OnDisable) *\*] \[-[PercentageMembers](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#PercentageMembers) *\*] \[-[PoolMembersType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#PoolMembersType) *\*] \[-[PowerOnAssignedPoolMembers](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#PowerOnAssignedPoolMembers) *\*] \[-[Repeat](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Repeat) {Never | EveryDay | EveryWeek | Every2Weeks | EveryMonth | EveryYear | SpecificDays}] \[-[SpecificDays](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#SpecificDays) {Never | Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}] \[-[StartDateTime](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#StartDateTime) *\*] \[-[Type](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Type) *\*] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#CommonParameters)*>*]\ \ New-RASSchedule \[-[Name](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Name)] *\* \[\[-[SiteId](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#SiteId)] *\*] -[Action](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Action) {Disable | Reboot | Startup | Shutdown} -[ObjType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#ObjType) {RDS | VDI | AVD} -[TargetID](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#TargetID) *\* -[TargetType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#TargetType) {Host | HostPool} \[-[CompleteIn](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#CompleteIn) *\*] \[-[Description](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Description) *\*] \[-[DurationInSecs](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#DurationInSecs) *\*] \[-[Enabled](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Enabled) *\*] \[-[EnableDrainMode](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#EnableDrainMode) *\*] \[-[EnforceScheduleInactiveHost](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#EnforceScheduleInactiveHost) *\*] \[-[ForceServerRebootAfter](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#ForceServerRebootAfter) *\*] \[-[MembersToStart](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#MembersToStart) *\*] \[-[OnDisable](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#OnDisable) *\*] \[-[PercentageMembers](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#PercentageMembers) *\*] \[-[PoolMembersType](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#PoolMembersType) *\*] \[-[PowerOnAssignedPoolMembers](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#PowerOnAssignedPoolMembers) *\*] \[-[Repeat](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Repeat) {Never | EveryDay | EveryWeek | Every2Weeks | EveryMonth | EveryYear | SpecificDays}] \[-[SpecificDays](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#SpecificDays) {Never | Sunday | Monday | Tuesday | Wednesday | Thursday | Friday | Saturday}] \[-[StartDateTime](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#StartDateTime) *\*] \[-[Type](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#Type) *\*] \[*<*[*CommonParameters*](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/cmdlets/New-RASSchedule.html#CommonParameters)*>*]\
### DESCRIPTION Creates a new Schedule property.\
### PARAMETERS \ -**Name \**\ Schedule name.\
``` Required? true ``` ``` Position? 0 ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SiteId \**\ Site ID from which to retrieve the schedule.\
``` Required? false ``` ``` Position? 1 ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ObjType <**[**ScheduleObjType**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/ScheduleObjType.html)**>**\ Schedule object type.\ \ Possible values: RDS, VDI, AVD\
``` Required? true ``` ``` Position? named ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Action <**[**ScheduleActionType**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/ScheduleActionType.html)**>**\ Schedule Action Type\ \ Possible values: Disable, Reboot, Startup, Shutdown\
``` Required? true ``` ``` Position? named ``` ``` Default value Disable ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**TargetType <**[**ScheduleTargetType**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/ScheduleTargetType.html)**>**\ Schedule target type. Accepted values: Host, Host Pool.\ \ Possible values: Host, HostPool\
``` Required? true ``` ``` Position? named ``` ``` Default value Host ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Enabled \**\ Whether to enable or disable the schedule.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Description \**\ Schedule description.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Type \**\ Type\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**TargetID \**\ The target RD Session Host server or server group Ids depending on the TargetType parameter.\
``` Required? true ``` ``` Position? named ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PoolId \**\ Pool Id\
``` Required? true ``` ``` Position? named ``` ``` Default value 0 ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**GUID \**\ GUID\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**GuestName \**\ Guest Name\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**HostAzureID \**\ Host Azure ID\
``` Required? true ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**StartDateTime \**\ Start time. Default: Now.\
``` Required? false ``` ``` Position? named ``` ``` Default value 12/7/2023 10:24:12 AM ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**DurationInSecs \**\ Duration in seconds.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**Repeat <**[**RepeatType**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/RepeatType.html)**>**\ Repeat interval. Default: EveryWeek\ \ Accepted values: Never, EveryDay, EveryWeek, Every2Weeks, EveryMonth, EveryYear.\ \ Possible values: Never, EveryDay, EveryWeek, Every2Weeks, EveryMonth, EveryYear, SpecificDays\
``` Required? false ``` ``` Position? named ``` ``` Default value EveryWeek ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**SpecificDays <**[**RepeatSpecificDays**](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/RepeatSpecificDays.html)**>**\ Repeat on Specific Days.\ \ Possible values: Never, Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday\
``` Required? false ``` ``` Position? named ``` ``` Default value Never ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**CompleteIn \**\ The duration of the scheduler task in minutes.\ \ Default: 15 minutes for disable task, 10 minutes for reboot task.\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PoolMembersType \**\ Pool Members Type\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PercentageMembers \**\ Percentage of members\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**MembersToStart \**\ Specific number of members to be started\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**PowerOnAssignedPoolMembers \**\ Power On Assigned Pool Members\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**EnableDrainMode \**\ Enable Drain Mode\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**ForceServerRebootAfter \**\ Force server reboot after\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**EnforceScheduleInactiveHost \**\ Enforce schedule for currently inactive host\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ -**OnDisable \**\ On Disable\
``` Required? false ``` ``` Position? named ``` ``` Default value ``` ``` Accept pipeline input? false ``` ``` Accept wildcard characters? false ``` \ \ ``` 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 [Schedule](https://download.parallels.com/ras/v19/docs/en_US/Parallels-RAS-v19-PowerShell-Guide/RASAdmin/types/Schedule.html) ### EXAMPLES \ \&#xNAN;**---------- EXAMPLE 1 ----------**\ \ New-RASSchedule "My Schedule" -ObjType RDS -Action Disable -TargetType Server\ \ Creates a new Schedule property with the specified name. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.parallels.com/landing/ras-powershell-api-guide/v19/parallels-ras-powershell-admin-module/commands/new-rasschedule.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.