New-UnitySnapSchedule
SYNOPSIS
Creates a new snapshot schedule.
SYNTAX
New-UnitySnapSchedule [-session <Object>] [-name] <String[]> -type <ScheduleTypeEnum> [-minute <UInt32>]
[-hours <UInt32[]>] [-daysOfWeek <DayOfWeekEnum[]>] [-daysOfMonth <UInt32>] [-interval <UInt32>]
[-isAutoDelete <Boolean>] [-retentionTime <UInt64>] [-accessType <FilesystemSnapAccessTypeEnum>] [-WhatIf]
[-Confirm]
DESCRIPTION
Creates a new snapshot schedule. You need to have an active session with the array.
EXAMPLES
-------------------------- EXAMPLE 1 --------------------------
New-UnitySnapSchedule -Name 'SCHEDULE01' -Type N_HOURS_AT_MM -Interval 12 -Minute 30
Create snapshot schedule named 'SCHEDULE01'. Snap every 12 hours, at 30 minutes past the hour.
PARAMETERS
-session
Specify an UnitySession Object.
Type: Object
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: ($global:DefaultUnitySession | where-object {$_.IsConnected -eq $true})
Accept pipeline input: False
Accept wildcard characters: False
-name
Name of new schedule.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-type
Type of snapshot schedule rule. Values are: - N_HOURS_AT_MM: Snap every \<interval> hours, at \<minutes> past the hour. Supported parameters: interval (required), minutes (optional, default 0). - DAY_AT_HHMM: Specify a list of \<hour[,...]> to snap one or more times each day at \<minutes> past the hour. Supported parameters: hours (at least one required), minutes (optional).
- N_DAYS_AT_HHMM: Snap every \<interval> days at the time \<hours>:\<minutes>. Supported Parameters: interval (required), hours (optional, exactly one), minutes (optional).
- SELDAYS_AT_HHMM: Snap on the selected \<daysOfWeek>, at the time \<hours>:\<minutes>. Supported parameters: daysOfWeek (at least one required), hours (optional, default 0), minutes (optional, default 0).
- NTH_DAYOFMONTH_AT_HHMM: Snap on the selected \<daysOfMonth>, at the time \<hours>:\<minutes>. Supported parameters: daysOfMonth (at least one required), hours (optional, default 0), minutes (optional, default 0).
Type: ScheduleTypeEnum
Parameter Sets: (All)
Aliases:
Accepted values: N_HOURS_AT_MM, DAY_AT_HHMM, N_DAYS_AT_HHMM, SELDAYS_AT_HHMM, NTH_DAYOFMONTH_AT_HHMM, UNSUPPORTED
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-minute
Minute frequency for the snapshot schedule rule.
Type: UInt32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-hours
Hourly frequency for the snapshot schedule rule.
Type: UInt32[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-daysOfWeek
Days of the week for which the snapshot schedule rule applies.
Type: DayOfWeekEnum[]
Parameter Sets: (All)
Aliases:
Accepted values: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday, Saturday
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-daysOfMonth
Days of the month for which the snapshot schedule rule applies.
Type: UInt32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-interval
Number of days or hours between snaps, depending on the rule type.
Type: UInt32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-isAutoDelete
Indicates whether the system can automatically delete the snapshot based on pool automatic-deletion thresholds. Values are: - $True: System can delete the snapshot based on pool automatic-deletion thresholds. - $False: System cannot delete the snapshot based on pool automatic-deletion thresholds.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-retentionTime
(Applies when the value of the isAutoDelete attribute is false.) Period of time in seconds for which to keep the snapshot.
Type: UInt64
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
-accessType
For a file system or VMware NFS datastore snapshot schedule, indicates whether the snapshot created by the schedule has checkpoint or protocol type access
Type: FilesystemSnapAccessTypeEnum
Parameter Sets: (All)
Aliases:
Accepted values: Checkpoint, Protocol
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf
Indicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Confirm
If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation.
Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
INPUTS
OUTPUTS
NOTES
Written by Erwan Quelin under MIT licence - https://github.com/equelin/Unity-Powershell/blob/master/LICENSE