Get-DPMJob

Get-DPMJob

Retrieves a list of current and previous jobs on a DPM server.

Syntax

Parameter Set: GetJobsDPM
Get-DPMJob [[-DPMServerName] <String> ] [[-Type] {Recovery | InitialReplication | Validation | ShadowCopy | Replication | MediaErase | DriveCleaning | DetailedInventory | Verification | DatasetCopy | ArchiveFromSC | RecoveryTape | LibraryRescan | DumpMedia | MediaRecatalog | OnlineRecatalog | FastInventory | CopyDataFromVolume | StagingAreaRestore | SharePointExportAndImport | SharePointCatalog | CloudBackup | CloudToStagingAreaRestore | StagingAreaToPsRecovery | StagingAreaToPsRestore}[] ] [[-Status] {Completed | Failed | InProgress | Scheduled}[] ] [[-From] <DateTime> ] [[-To] <DateTime> ] [[-Newest]] [[-AdhocJobs]] [ <CommonParameters>]

Parameter Set: GetJobsDS
Get-DPMJob [-Datasource] <Datasource[]> [[-Type] {Recovery | InitialReplication | Validation | ShadowCopy | Replication | MediaErase | DriveCleaning | DetailedInventory | Verification | DatasetCopy | ArchiveFromSC | RecoveryTape | LibraryRescan | DumpMedia | MediaRecatalog | OnlineRecatalog | FastInventory | CopyDataFromVolume | StagingAreaRestore | SharePointExportAndImport | SharePointCatalog | CloudBackup | CloudToStagingAreaRestore | StagingAreaToPsRecovery | StagingAreaToPsRestore}[] ] [[-Status] {Completed | Failed | InProgress | Scheduled}[] ] [[-From] <DateTime> ] [[-To] <DateTime> ] [[-Newest]] [[-AdhocJobs]] [ <CommonParameters>]

Parameter Set: GetJobsDSName
Get-DPMJob [-DatasourceName] <String[]> [[-DPMServerName] <String> ] [[-Type] {Recovery | InitialReplication | Validation | ShadowCopy | Replication | MediaErase | DriveCleaning | DetailedInventory | Verification | DatasetCopy | ArchiveFromSC | RecoveryTape | LibraryRescan | DumpMedia | MediaRecatalog | OnlineRecatalog | FastInventory | CopyDataFromVolume | StagingAreaRestore | SharePointExportAndImport | SharePointCatalog | CloudBackup | CloudToStagingAreaRestore | StagingAreaToPsRecovery | StagingAreaToPsRestore}[] ] [[-Status] {Completed | Failed | InProgress | Scheduled}[] ] [[-From] <DateTime> ] [[-To] <DateTime> ] [[-Newest]] [[-AdhocJobs]] [ <CommonParameters>]

Parameter Set: GetJobsPG
Get-DPMJob [-ProtectionGroup] <ProtectionGroup[]> [[-Type] {Recovery | InitialReplication | Validation | ShadowCopy | Replication | MediaErase | DriveCleaning | DetailedInventory | Verification | DatasetCopy | ArchiveFromSC | RecoveryTape | LibraryRescan | DumpMedia | MediaRecatalog | OnlineRecatalog | FastInventory | CopyDataFromVolume | StagingAreaRestore | SharePointExportAndImport | SharePointCatalog | CloudBackup | CloudToStagingAreaRestore | StagingAreaToPsRecovery | StagingAreaToPsRestore}[] ] [[-Status] {Completed | Failed | InProgress | Scheduled}[] ] [[-From] <DateTime> ] [[-To] <DateTime> ] [[-Newest]] [[-AdhocJobs]] [ <CommonParameters>]

Parameter Set: GetJobsPS
Get-DPMJob [-ProductionServer] <ProductionServer[]> [[-Type] {Recovery | InitialReplication | Validation | ShadowCopy | Replication | MediaErase | DriveCleaning | DetailedInventory | Verification | DatasetCopy | ArchiveFromSC | RecoveryTape | LibraryRescan | DumpMedia | MediaRecatalog | OnlineRecatalog | FastInventory | CopyDataFromVolume | StagingAreaRestore | SharePointExportAndImport | SharePointCatalog | CloudBackup | CloudToStagingAreaRestore | StagingAreaToPsRecovery | StagingAreaToPsRestore}[] ] [[-Status] {Completed | Failed | InProgress | Scheduled}[] ] [[-From] <DateTime> ] [[-To] <DateTime> ] [[-Newest]] [[-AdhocJobs]] [ <CommonParameters>]

Parameter Set: GetJobsPSName
Get-DPMJob [-ProductionServerName] <String[]> [[-DPMServerName] <String> ] [[-Type] {Recovery | InitialReplication | Validation | ShadowCopy | Replication | MediaErase | DriveCleaning | DetailedInventory | Verification | DatasetCopy | ArchiveFromSC | RecoveryTape | LibraryRescan | DumpMedia | MediaRecatalog | OnlineRecatalog | FastInventory | CopyDataFromVolume | StagingAreaRestore | SharePointExportAndImport | SharePointCatalog | CloudBackup | CloudToStagingAreaRestore | StagingAreaToPsRecovery | StagingAreaToPsRestore}[] ] [[-Status] {Completed | Failed | InProgress | Scheduled}[] ] [[-From] <DateTime> ] [[-To] <DateTime> ] [[-Newest]] [[-AdhocJobs]] [ <CommonParameters>]

Parameter Set: UpdateJobsDPM
Get-DPMJob [-Job] <Job[]> [ <CommonParameters>]

Detailed Description

The Get-DPMJob cmdlet retrieves a list of current and previous jobs on a System Center 2012 – Data Protection Manager (DPM) server.

Parameters

-AdhocJobs

Indicates that the cmdlet retrieves only ad hoc jobs, not scheduled jobs.

Aliases

none

Required?

false

Position?

7

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Datasource<Datasource[]>

Specifies an array of data source objects.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-DatasourceName<String[]>

Specifies an array of names of data sources.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-DPMServerName<String>

Specifies the name of a DPM server.

Aliases

ComputerName,CN

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-From<DateTime>

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

Aliases

none

Required?

false

Position?

4

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Job<Job[]>

Specifies a list of jobs.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Newest

Indicates the last job that ran on the filter objects.

Aliases

none

Required?

false

Position?

6

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProductionServer<ProductionServer[]>

Specifies an array of protected computer objects.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-ProductionServerName<String[]>

Specifies an array of names of protected computers.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-ProtectionGroup<ProtectionGroup[]>

Specifies an array of protection group objects.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-Status<JobStatusType[]>

Specifies an array of job status types.

Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-To<DateTime>

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.

Aliases

none

Required?

false

Position?

6

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Type<DPMJobType[]>

Specifies an array of DPM job types. 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

Aliases

none

Required?

false

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (http://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Examples

Example 1: Retrieve recent jobs

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

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

Example 2: Retrieve recent jobs for a protection group

This example returns a list of recent jobs run on protection groups on the DPM server named Contoso-DPMServer.

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

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

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

Restart-DPMJob

Stop-DPMJob