Set-DPMMaintenanceJobStartTime

Sets the start time of a maintenance job or stops such a job from running.

Syntax

Set-DPMMaintenanceJobStartTime
   [[-DPMServerName] <String>]
   [-MaintenanceJob] <HouseKeepingJobs>
   [[-StartTime] <DateTime>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-DPMMaintenanceJobStartTime
   [[-DPMServerName] <String>]
   [-MaintenanceJob] <HouseKeepingJobs>
   [-Remove]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The Set-DPMMaintenanceJobStartTime cmdlet sets the start time of a maintenance job or stops such a job if it is running in System Center - Data Protection Manager (DPM).

You can reschedule Catalog Pruning and Detailed Inventory jobs by using this cmdlet.

Examples

Example 1: Set the start time for a job

PS C:\>Set-DPMMaintenanceJobStartTime -DPMServerName "DPMServer07" -MaintenanceJob CatalogPruning -StartTime 02:00

This command schedules the CatalogPruning maintenance job to run on the DPM server named DPMServer07 at 2 AM.

Example 2: Remove scheduled job

PS C:\>Set-DPMMaintenanceJobStartTime -DPMServerName "DPMServer07" -MaintenanceJob LibraryInventory -Remove

This command removes the scheduled LibraryInventory job and prevents it from running on the DPM server named DPMServer07, in future.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DPMServerName

Specifies the name of a DPM server on which this cmdlet sets a maintenance job.

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

-MaintenanceJob

Specifies the maintenance job that the cmdlet performs on the replica. Valid values are:

  • CatalogPruning. Removes index entries for expired tapes.
  • DetailedInventory. Identifies new tapes and recognizes tapes DPM has seen before by reading the on-media identifier (OMID) on each tape.
Type:HouseKeepingJobs
Accepted values:CatalogPruning, LibraryInventory
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Remove

Indicates that the cmdlet stops the job that is currently running.

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

-StartTime

Specifies the time when the operation starts as a DateTime object.

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False