Set-DPMProtectionJobStartTime
Set-DPMProtectionJobStartTime
Sets the start time of a protection job.
Syntax
Parameter Set: Edit
Set-DPMProtectionJobStartTime [-ProtectionGroup] <ProtectionGroup> [-JobType] <GetProtectionJobStartTime+ProtectionJobType> {ConsistencyCheck} [-StartTime] <DateTime> [-MaximumDurationInHours] <Int32> [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: OffsetSchedule
Set-DPMProtectionJobStartTime [-ProtectionGroup] <ProtectionGroup> [-CatalogOffset] <Int32> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Remove
Set-DPMProtectionJobStartTime [-ProtectionGroup] <ProtectionGroup> [-JobType] <GetProtectionJobStartTime+ProtectionJobType> {ConsistencyCheck} -Remove [-PassThru] [-Confirm] [-WhatIf] [ <CommonParameters>]
Detailed Description
The Set-DPMProtectionJobStartTime cmdlet sets the start time of a protection job. The only type of protection job that is currently available is consistency check. Use the Remove parameter to stop a protection job.
Parameters
-CatalogOffset<Int32>
Specifies the number of minutes, after the first scheduled recovery point creation time of the SharePoint farm, that DPM creates the catalog.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-JobType<GetProtectionJobStartTime+ProtectionJobType>
Specifies the type of job for which options are being set. The only valid value for this parameter is ConsistencyCheck.
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-MaximumDurationInHours<Int32>
Specify the maximum number of hours that DPM can run a job.
Aliases |
none |
Required? |
true |
Position? |
4 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-PassThru
Returns an object representing the item with which you are working. By default, this cmdlet does not generate any output.
Aliases |
none |
Required? |
false |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-ProtectionGroup<ProtectionGroup>
Specifies a protection group. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.
Aliases |
none |
Required? |
true |
Position? |
1 |
Default Value |
none |
Accept Pipeline Input? |
True (ByValue) |
Accept Wildcard Characters? |
false |
-Remove
Indicates that DPM stops the protection job.
Aliases |
none |
Required? |
true |
Position? |
named |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-StartTime<DateTime>
Specifies a start time for the protection job.
Aliases |
none |
Required? |
true |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Confirm
Prompts you for confirmation before running the cmdlet.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-WhatIf
Shows what would happen if the cmdlet runs. The cmdlet is not run.
Required? |
false |
Position? |
named |
Default Value |
false |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
Outputs
The output type is the type of the objects that the cmdlet emits.
- ProtectionGroup
Examples
Example 1: Schedule a consistency check on a protection group
The first command gets the protection group on the DPM server named DPMServer02, and then stores it in the $PGroup variable.
The second command makes the protection group in $PGroup modifiable, and stores the result in the $MPGroup variable.
The third command sets the start time of the protection job in $MPGroup. The command schedules for a consistency check to run on the protection group at 2:00 AM every day.
The final command uses the Set-DPMProtectionGroup cmdlet to save your changes.
PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $MPGroup = Get-DPMModifiableProtectionGroup -ProtectionGroup $PGroup
PS C:\> Set-DPMProtectionJobStartTime -ProtectionGroup $MPGroup -JobType ConsistencyCheck -StartTime 02:00
PS C:\> Set-DPMProtectionGroup ProtectionGroup $MPGroup