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 2016 - 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: Stop a running job

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

This command stops the LibraryInventory job from running on the DPM server named DPMServer07.

Required Parameters

-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
Parameter Sets:CatalogPruning, LibraryInventory
Position:2
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value: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
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
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
Accept pipeline input:True (ByValue)
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
Accept pipeline input:False
Accept wildcard characters:False