Set-DPMMaintenanceJobStartTime

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

Syntax

Set-DPMMaintenanceJobStartTime [[-DPMServerName] <String>] [-MaintenanceJob] <HouseKeepingJobs> [-Remove]
 [-Confirm] [-WhatIf] [<CommonParameters>]
Set-DPMMaintenanceJobStartTime [[-DPMServerName] <String>] [-MaintenanceJob] <HouseKeepingJobs>
 [[-StartTime] <DateTime>] [-Confirm] [-WhatIf] [<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.

Parameters

-DPMServerName

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

Type:String
Required:False
Position:1
Default value:None
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
Parameter Sets:CatalogPruning, LibraryInventory
Required:True
Position:2
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
Required:False
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
Required:False
Position:3
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
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.

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