Get-DPMJob

Module:

DataProtectionManager Module

Gets current and previous jobs on a DPM server.

Syntax

GetJobsDPM (Default)

Get-DPMJob
    [[-DPMServerName] <String>]
    [[-From] <DateTime>]
    [[-To] <DateTime>]
    [[-Type] <DPMJobType[]>]
    [[-Status] <JobStatusType[]>]
    [-NoLimitOnJobCount]
    [-AllJobsInInterval]
    [-Newest]
    [-AdhocJobs]
    [<CommonParameters>]

GetJobsPSName

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

GetJobsDSName

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

GetJobsDS

Get-DPMJob
    [[-From] <DateTime>]
    [[-To] <DateTime>]
    [-Datasource] <Datasource[]>
    [[-Type] <DPMJobType[]>]
    [[-Status] <JobStatusType[]>]
    [-NoLimitOnJobCount]
    [-AllJobsInInterval]
    [-Newest]
    [-AdhocJobs]
    [<CommonParameters>]

GetJobsPG

Get-DPMJob
    [[-From] <DateTime>]
    [[-To] <DateTime>]
    [-ProtectionGroup] <ProtectionGroup[]>
    [[-Type] <DPMJobType[]>]
    [[-Status] <JobStatusType[]>]
    [-NoLimitOnJobCount]
    [-AllJobsInInterval]
    [-Newest]
    [-AdhocJobs]
    [<CommonParameters>]

GetJobsPS

Get-DPMJob
    [[-From] <DateTime>]
    [[-To] <DateTime>]
    [-ProductionServer] <ProductionServer[]>
    [[-Type] <DPMJobType[]>]
    [[-Status] <JobStatusType[]>]
    [-NoLimitOnJobCount]
    [-AllJobsInInterval]
    [-Newest]
    [-AdhocJobs]
    [<CommonParameters>]

UpdateJobsDPM

Get-DPMJob
    [-Job] <Job[]>
    [<CommonParameters>]

Description

The Get-DPMJob cmdlet gets current and previous jobs on a System Center - 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.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDPM

Position:	7
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	7
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	7
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDS

Position:	7
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPG

Position:	7
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPS

Position:	7
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-AllJobsInInterval

Indicates that this cmdlet gets all jobs.

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDPM

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDS

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPG

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPS

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	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.

Parameter properties

Type:	Datasource[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDS

Position:	1
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DatasourceName

Specifies an array of names of data sources.

Parameter properties

Type:	String[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDSName

Position:	1
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-DPMServerName

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

Parameter properties

Type:	String
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	ComputerName, CN

Parameter sets

GetJobsDPM

Position:	1
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	1
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	1
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	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.

Parameter properties

Type:	DateTime
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDPM

Position:	4
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	4
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	4
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDS

Position:	4
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPG

Position:	4
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPS

Position:	4
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Job

Specifies an array of jobs that this cmdlet gets.

Parameter properties

Type:	Job[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

UpdateJobsDPM

Position:	1
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Newest

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

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDPM

Position:	6
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	6
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	6
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDS

Position:	6
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPG

Position:	6
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPS

Position:	6
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-NoLimitOnJobCount

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

Parameter properties

Type:	SwitchParameter
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDPM

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDS

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPG

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPS

Position:	Named
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ProductionServer

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

Parameter properties

Type:	ProductionServer[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsPS

Position:	1
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ProductionServerName

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

Parameter properties

Type:	String[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsPSName

Position:	1
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-ProtectionGroup

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

Parameter properties

Type:	ProtectionGroup[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsPG

Position:	1
Mandatory:	True
Value from pipeline:	True
Value from pipeline by property name:	False
Value from remaining arguments:	False

-Status

Specifies an array of job status types.

Parameter properties

Type:	JobStatusType[]
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDPM

Position:	3
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	3
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	3
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDS

Position:	3
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPG

Position:	3
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPS

Position:	3
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	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.

Parameter properties

Type:	DateTime
Default value:	None
Supports wildcards:	False
DontShow:	False

Parameter sets

GetJobsDPM

Position:	5
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	5
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	5
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDS

Position:	5
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPG

Position:	5
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPS

Position:	5
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	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

Parameter properties

Type:	DPMJobType[]
Default value:	None
Supports wildcards:	False
DontShow:	False
Aliases:	JobCategory, JobType

Parameter sets

GetJobsDPM

Position:	2
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPSName

Position:	2
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDSName

Position:	2
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsDS

Position:	2
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPG

Position:	2
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

GetJobsPS

Position:	2
Mandatory:	False
Value from pipeline:	False
Value from pipeline by property name:	False
Value from remaining arguments:	False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Related Links

• Get-DPMProtectionGroup
• Restart-DPMJob
• Stop-DPMJob