New-RDSScheduleReboot

NAME

New-RDSScheduleReboot

SYNOPSIS

Creates an RD Session Host scheduler job of type "Reboot (server or group)".

SYNTAX

New-RDSScheduleReboot -Name <string> -StartDateTime <DateTime> -TargetType <SchedTargetType> {Server | ServerGroup} [-CompleteRebootInSecs <uint>] [-Description <string>] [-DrainMode <SwitchParameter>] [-EnforceOnInactive <bool>] [-ForceRebootDelayMins <uint>] [-Message <string>] [-MessageTitle <string>] [-Repeat <RepeatType> {Never | EveryDay | EveryWeek | Every2Weeks | EveryMonth | EveryYear}] [-SendMsgBeforeMins <uint>] [-SiteId <uint>] [-TargetGroup <RDSGroup>] [-TargetServer <RDS>] [<CommonParameters>]

DESCRIPTION

Creates an RD Session Host scheduler job of type "Reboot (server or group)".

PARAMETERS


-DrainMode <SwitchParameter>
Whether to enables or disable the Drain mode. 

        Required?                    false
        Position?                    named
        Default value                False
        Accept pipeline input?       false
        Accept wildcard characters?  false

-ForceRebootDelayMins <uint>
Force reboot after (in minutes). 

        Required?                    false
        Position?                    named
        Default value                60
        Accept pipeline input?       false
        Accept wildcard characters?  false

-ForceRebootAfterMins <uint>
Force reboot after (in minutes).

This is an alias of the ForceRebootDelayMins parameter. 

        Required?                    false
        Position?                    named
        Default value                60
        Accept pipeline input?       false
        Accept wildcard characters?  false

-CompleteRebootInSecs <uint>
Complete in (seconds). 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-CompleteInSec <uint>
Complete in (seconds).

This is an alias of the CompleteRebootInSecs parameter. 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Name <string>
Scheduler job name. 

        Required?                    true
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-TargetType <SchedTargetType>
Scheduler job target type. Accepted values: Server, ServerGroup.

Possible values: Server, ServerGroup 

        Required?                    true
        Position?                    named
        Default value                Server
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Description <string>
Scheduler job description. 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-StartDateTime <DateTime>
Start time. 

        Required?                    true
        Position?                    named
        Default value                1/1/0001 12:00:00 AM
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Start <DateTime>
Start time.

This is an alias of the StartDateTime parameter. 

        Required?                    true
        Position?                    named
        Default value                1/1/0001 12:00:00 AM
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Repeat <RepeatType>
Repeat interval.

Accepted values: Never, EveryDay, EveryWeek, Every2Weeks, EveryMonth, EveryYear.

Possible values: Never, EveryDay, EveryWeek, Every2Weeks, EveryMonth, EveryYear 

        Required?                    false
        Position?                    named
        Default value                EveryWeek
        Accept pipeline input?       false
        Accept wildcard characters?  false

-MessageTitle <string>
The title of the message. 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-Message <string>
A message that should be sent to users before the job starts. 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-SendMsgBeforeMins <uint>
Time interval in minutes before the job starts when the message to users should be sent. 

        Required?                    false
        Position?                    named
        Default value                1
        Accept pipeline input?       false
        Accept wildcard characters?  false

-SiteId <uint>
The site ID to which to add the scheduler job.

If the parameter is omitted, the Licensing Server site ID will be used. 

        Required?                    false
        Position?                    named
        Default value                0
        Accept pipeline input?       false
        Accept wildcard characters?  false

-TargetServer <RDS>
The target RD Session Host server if the TargetType parameter is set to 'Server'. 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-TargetGroup <RDS>
The target server group if the TargetType parameter is set to ServerGroup. 

        Required?                    false
        Position?                    named
        Default value                
        Accept pipeline input?       false
        Accept wildcard characters?  false

-EnforceOnInactive <bool>
Enforced the schedule even when the target is inactive. 

        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 documentation.

INPUTS

-none-

OUTPUTS

RDSSchedItem

EXAMPLES


---------- EXAMPLE 1 ----------

New-RDSScheduleReboot

Creates a schedule job with the specified settings.

---------- EXAMPLE 2 ----------

New-RDSScheduleReboot -Name "schedule_job" -StartDateTime "11/06/2019 16:27:04" -TargetType Server -TargetServer $rds

Creates a schedule job with the specified settings, with a given start time.

---------- EXAMPLE 3 ----------

New-RDSScheduleReboot -Name "schedule_reboot_2" -TargetType Server -StartDateTime "09/08/2019 12:55:00" -TargetServer $rds -Repeat EveryWeek -Description "Weekly reboot"

Creates a schedule job with the specified settings, with a given start time which repeats every week.

RELATED LINKS