Get-DPMJob

Gets current and previous jobs on a DPM server.

Syntax

Get-DPMJob
   [[-DPMServerName] <String>]
   [[-From] <DateTime>]
   [[-To] <DateTime>]
   [-NoLimitOnJobCount]
   [-AllJobsInInterval]
   [[-Type] <DPMJobType[]>]
   [[-Status] <JobStatusType[]>]
   [-Newest]
   [-AdhocJobs]
   [<CommonParameters>]
Get-DPMJob
   [[-DPMServerName] <String>]
   [[-From] <DateTime>]
   [[-To] <DateTime>]
   [-NoLimitOnJobCount]
   [-AllJobsInInterval]
   [-ProductionServerName] <String[]>
   [[-Type] <DPMJobType[]>]
   [[-Status] <JobStatusType[]>]
   [-Newest]
   [-AdhocJobs]
   [<CommonParameters>]
Get-DPMJob
   [[-DPMServerName] <String>]
   [[-From] <DateTime>]
   [[-To] <DateTime>]
   [-NoLimitOnJobCount]
   [-AllJobsInInterval]
   [-DatasourceName] <String[]>
   [[-Type] <DPMJobType[]>]
   [[-Status] <JobStatusType[]>]
   [-Newest]
   [-AdhocJobs]
   [<CommonParameters>]
Get-DPMJob
   [[-From] <DateTime>]
   [[-To] <DateTime>]
   [-NoLimitOnJobCount]
   [-AllJobsInInterval]
   [-Datasource] <Datasource[]>
   [[-Type] <DPMJobType[]>]
   [[-Status] <JobStatusType[]>]
   [-Newest]
   [-AdhocJobs]
   [<CommonParameters>]
Get-DPMJob
   [[-From] <DateTime>]
   [[-To] <DateTime>]
   [-NoLimitOnJobCount]
   [-AllJobsInInterval]
   [-ProtectionGroup] <ProtectionGroup[]>
   [[-Type] <DPMJobType[]>]
   [[-Status] <JobStatusType[]>]
   [-Newest]
   [-AdhocJobs]
   [<CommonParameters>]
Get-DPMJob
   [[-From] <DateTime>]
   [[-To] <DateTime>]
   [-NoLimitOnJobCount]
   [-AllJobsInInterval]
   [-ProductionServer] <ProductionServer[]>
   [[-Type] <DPMJobType[]>]
   [[-Status] <JobStatusType[]>]
   [-Newest]
   [-AdhocJobs]
   [<CommonParameters>]
Get-DPMJob
   [-Job] <Job[]>
   [<CommonParameters>]

Description

The Get-DPMJob cmdlet gets current and previous jobs on a System Center 2019 - Data Protection Manager (DPM) server.

Examples

Example 1: Retrieve recent jobs

PS C:\> Get-DPMJob -DPMServerName "Contoso-DPMServer" -Newest

This command returns the latest jobs run on the DPM server named Contoso-DPMServer.

Example 2: Retrieve recent jobs for a protection group

PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "Contoso-DPMServer"
PS C:\> Get-DPMJob -ProtectionGroup $PGroup

The first command uses the Get-ProtectionGroup cmdlet to get the protection group, and then stores the group in the $PGroup variable.

The second command uses the Get-DPMJob cmdlet to retrieve the recent jobs for the protection group in $PGroup.

Parameters

-AdhocJobs

Indicates that this cmdlet gets only ad hoc jobs, not scheduled jobs.

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

-AllJobsInInterval

Indicates that this cmdlet gets all jobs.

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

-Datasource

Specifies an array of data source objects for which this cmdlet gets jobs. A data source can be a file system share or volume for the Windows operating system, Microsoft SQL Server database, Microsoft Exchange Server storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, DPM database, or system state that is a member of a protection group.

Type:Datasource[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-DatasourceName

Specifies an array of names of data sources.

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

-DPMServerName

Specifies the name of a DPM server. This cmdlet gets jobs that run on the server that this parameter specifies.

Type:String
Aliases:ComputerName, CN
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-From

Specifies the starting time in a range. The cmdlet gets jobs that fall into this range. Use the To parameter to specify the ending time in the range.

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

-Job

Specifies an array of jobs that this cmdlet gets.

Type:Job[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Newest

Indicates that this cmdlet gets only the last job that ran on the filter objects.

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

-NoLimitOnJobCount

Indicates there is no limit on the job count to get.

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

-ProductionServer

Specifies an array of computers on which DPM protection agents are installed.

Type:ProductionServer[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProductionServerName

Specifies an array names of computers on which DPM protection agents are installed.

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

-ProtectionGroup

Specifies an array of protection groups for which this cmdlet gets jobs. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.

Type:ProtectionGroup[]
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Status

Specifies an array of job status types.

Type:JobStatusType[]
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-To

Specifies the ending time in a range. The cmdlet retrieves jobs that fall into this range. Use the From parameter to specify the starting time in the range.

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

-Type

Specifies an array of DPM job types.

The acceptable values for this parameter are:

  • Recovery
  • InitialReplication
  • Validation
  • ShadowCopy
  • Replication
  • MediaErase
  • DriveCleaning
  • DetailedInventory
  • Verification
  • DatasetCopy
  • ArchiveFromSC
  • RecoveryTape
  • LibraryRescan
  • DumpMedia
  • MediaRecatalog
  • OnlineRecatalog
  • FastInventory
  • CopyDataFromVolume
  • StagingAreaRestore
  • SharePointImportAndExport
  • SharePointCatalog
  • CloudBackup
  • CloudToStagingAreaRestore
  • StagingAreaToPsRecovery
  • StagingAreaToPsRestore
Type:DPMJobType[]
Aliases:JobCategory, JobType
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False