Citrix Virtual Apps and Desktops SDK

New-ProvVMBackupSchedule

Introduced in: Citrix Virtual Apps and Desktop 7 2407

Creates new schedules

Syntax

New-ProvVMBackupSchedule
   -ProvisioningScheduleName <String>
   -ProvisioningSchemeName <String[]>
   -ScheduledStartTimeInUTC <DateTime>
   [-MaxAllocatedDurationInMinutes <Int32>]
   [-SessionWarningInMinutes <Int32>]
   [-SessionWarningLogOffMessage <String>]
   [-PurgeMaintenanceCycleInfoAfterInDays <Int32>]
   -RecurringSchedule <ProvisioningScheduleFrequency>
   [-ScheduleDescription <String>]
   [-MaxNumberOfBackups <Int32>]
   [-LoggingId <Guid>]
   [<CitrixCommonParameters>]
   [<CommonParameters>]
<!--NeedCopy-->

Description

Creates a new Schedule for Backing up virtual machines in a provisioning scheme via maintenance cycles

Examples

Parameters

-ProvisioningScheduleName

A Unique name provided for the provisioning schedule

Type: String
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-ProvisioningSchemeName

Provisioning scheme associated with the provisioning schedule

Type: String[]
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-ScheduledStartTimeInUTC

Indicates the start time for the provisioning schedule

Type: DateTime
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-RecurringSchedule

Indicates how frequently rhe operation needs to be run, can be daily, weekly or monthly

Type: ProvisioningScheduleFrequency
Accepted values: Monthly, Biweekly, Weekly, Daily
Position: Named
Default value: None
Required: True
Accept pipeline input: False
Accept wildcard characters: False

-MaxAllocatedDurationInMinutes

Indicates the total allocated duration in minutes to the provisioning schedule

Type: Int32
Position: Named
Default value: 30
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-SessionWarningInMinutes

Buffer Time provided to the user to save data before powering down the vm by mcs

Type: Int32
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-SessionWarningLogOffMessage

Message intended to be displayed to the user before powering down the vm

Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-PurgeMaintenanceCycleInfoAfterInDays

The duration of time in days for mcs to wait before purging relevant info from the database upon completion

Type: Int32
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-ScheduleDescription

A brief overview of the provisioning schedule

Type: String
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-MaxNumberOfBackups

The maximum number of backups that can exist, per virtual machine as part of the provisioning schedule

Type: Int32
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

-LoggingId

Specifies the identifier of the high-level operation this cmdlet call forms a part of. Citrix Studio and Director typically create high-level operations. PowerShell scripts can also wrap a series of cmdlet calls in a high-level operation by way of the Start-LogHighLevelOperation and Stop-LogHighLevelOperation cmdlets.

Type: Guid
Position: Named
Default value: None
Required: False
Accept pipeline input: False
Accept wildcard characters: False

CitrixCommonParameters

This cmdlet supports the common Citrix parameters: -AdminAddress, -AdminClientIP, -BearerToken, -TraceParent, -TraceState and -VirtualSiteId. For more information, see about_CitrixCommonParameters.

CommonParameters

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

Inputs

None

You can’t pipe objects to this cmdlet.

Outputs

None

By default, this cmdlet returns no output.

New-ProvVMBackupSchedule