Get Data Source

Applies To: System Center 2012 - Orchestrator, System Center 2012 R2 Orchestrator, System Center 2012 SP1 - Orchestrator

The Get Data Source activity retrieves information about Data Sources from either a production server (a computer that has the Data Protection Manager Protection Agent installed) or from a protection group (a named entity that holds the backup policy for a workload). A data source is a workload that is currently protected or will be protected by Data Protection Manager. When the Get Data Source activity is used in a protection scenario, you select a production server which becomes the default. When this activity is used in a recovery scenario, you will select a protection group or the production Server.

The common filters for this activity are as follows:

  • Name contains or matches a pattern

  • Protected - True or False

This activity returns the Data Source ID (DataSourceId) which is used in all activities except Get DPM Server Capacity.

For the procedure to configure this object, see: Configuring the Get Data Source Activity.

The following tables list the properties and published data for this activity. The activity publishes all the data from the required and optional properties into published data.

Get Data Source Properties

Element Description

Data Source Location

Production Server or Protection Group

Name

The name of the target for this activity

Get Data Source Filters

Element Type

ActivelyProtectedByDatasourceId

GUID

CanDbFilesBeRecoveredToAlternateLocation

Boolean

CloudReplicaAllocationRequired

Boolean

CurrentlyProtected

Boolean

CustomFormatOption

Boolean

DatasourceId

GUID

Data Source Location

String

DatasourceName

String

DatasourceSize

Long

DiskAllocation

String

DisplayPath

String

FirstAddedTime

DateTime

ID

GUID

InactiveDiskAllocation

String

Instance

String

IsAutoCCEnabled

Boolean

IsAutoGrowEnabled

Boolean

IsBatchableOnSizeInquiry

Boolean

IsCloudProtectable

Boolean

IsCollocateable

Boolean

IsCollocated

Boolean

IsCustomAllocation

Boolean

IsDiskInactive

Boolean

IsDPMDatabase

Boolean

IsDPMDatasource

Boolean

IsExternalDatasource

Boolean

IsInstanceProtected

Boolean

IsLocalDPMDatabase

Boolean

IsMirroredDatabase

Boolean

IsOnlineInactive

Boolean

IsOwnerOfAssociatedReplica

Boolean

IsPresentOnCloud

Boolean

IsReferentialDatasource

Boolean

IsTapeInactive

Boolean

LastAddedToCurrentPG

DateTime

LatestRecoveryAllowed

Boolean

LatestRecoveryPoint

DateTime

LogicalPath

String

MinimumReplicaSizeAllowed

Long

MirroredServerInstance

String

MirroredServerName

String

Name

String

NeedsDiskAllocationModification

Boolean

NumberOfExcludedObjects

Integer

NumberOfProtectedObjects

Integer

OldestRecoveryPoint

DateTime

OptimizedSize

Long

OptimizedSizeOnDC

Long

OptimizedSizeOnReplica

Long

PrimaryDPMDatasourceId

GUID

PrincipalServerInstance

String

PrincipalServerName

String

ProductionServerName

String

Protected

Boolean

ProtectedOnCloud

Boolean

ProtectionGroupId

GUID

ProtectionGroupName

String

ReAllocationRequired

Boolean

RecoveryRangeInDays

Integer

ReferentialDatasourceId

GUID

ReferentialProtectionGroupId

GUID

ReplicaAssociationChanged

Boolean

ReplicaPath

String

ReplicaResizeRequired

Boolean

ReplicaSize

Long

ReplicaUsedSpace

Long

RequiredReplicaSize

Long

RequiredShadowCopyAreaSize

Long

ShadowCopyAreaSize

Long

ShadowCopySizeAfterMaxShrink

Long

ShadowCopySizeAfterMinShrink

Long

ShadowCopyUsedSpace

Long

SourceDPMServer

String

SqlScratchSpace

String

StopSQLServiceForRecovery

Boolean

SupportsIncremental

Boolean

TotalRecoveryPoints

Integer

Type

String

UnderActiveProtectionFromDPM

Boolean

UnderActiveProtectionFromPS

Boolean

UsnJournalLogSize

Long

Get Data Source Published Data

Element Type

ActivelyProtectedByDatasourceId

GUID

CanDbFilesBeRecoveredToAlternateLocation

Boolean

CloudReplicaAllocationRequired

Boolean

CurrentlyProtected

Boolean

CustomFormatOption

Boolean

DatasourceId

GUID

DatasourceName

String

DatasourceSize

Long

DiskAllocation

String

DisplayPath

String

FirstAddedTime

DateTime

ID

GUID

InactiveDiskAllocation

String

Instance

String

IsAutoCCEnabled

Boolean

IsAutoGrowEnabled

Boolean

IsBatchableOnSizeInquiry

Boolean

IsCloudProtectable

Boolean

IsCollocateable

Boolean

IsCollocated

Boolean

IsCustomAllocation

Boolean

IsDiskInactive

Boolean

IsDPMDatabase

Boolean

IsDPMDatasource

Boolean

IsExternalDatasource

Boolean

IsInstanceProtected

Boolean

IsLocalDPMDatabase

Boolean

IsMirroredDatabase

Boolean

IsOnlineInactive

Boolean

IsOwnerOfAssociatedReplica

Boolean

IsPresentOnCloud

Boolean

IsReferentialDatasource

Boolean

IsTapeInactive

Boolean

LastAddedToCurrentPG

DateTime

LatestRecoveryAllowed

Boolean

LatestRecoveryPoint

DateTime

LogicalPath

String

MinimumReplicaSizeAllowed

Long

MirroredServerInstance

String

MirroredServerName

String

Name

String

NeedsDiskAllocationModification

Boolean

NumberOfExcludedObjects

Integer

NumberOfProtectedObjects

Integer

OldestRecoveryPoint

DateTime

OptimizedSize

Long

OptimizedSizeOnDC

Long

OptimizedSizeOnReplica

Long

PrimaryDPMDatasourceId

GUID

PrincipalServerInstance

String

PrincipalServerName

String

ProductionServerName

String

Protected

Boolean

ProtectedOnCloud

Boolean

ProtectionGroupId

GUID

ProtectionGroupName

String

ReAllocationRequired

Boolean

RecoveryRangeInDays

Integer

ReferentialDatasourceId

GUID

ReferentialProtectionGroupId

GUID

ReplicaAssociationChanged

Boolean

ReplicaPath

String

ReplicaResizeRequired

Boolean

ReplicaSize

Long

ReplicaUsedSpace

Long

RequiredReplicaSize

Long

RequiredShadowCopyAreaSize

Long

ShadowCopyAreaSize

Long

ShadowCopySizeAfterMaxShrink

Long

ShadowCopySizeAfterMinShrink

Long

ShadowCopyUsedSpace

Long

SourceDPMServer

String

SqlScratchSpace

String

StopSQLServiceForRecovery

Boolean

SupportsIncremental

Boolean

TotalRecoveryPoints

Integer

Type

String

UnderActiveProtectionFromDPM

Boolean

UnderActiveProtectionFromPS

Boolean

UsnJournalLogSize

Long

Configuring the Get Data Source Activity

To configure the Get Data Source activity

  1. From the Activities window, drag a Get Data Source activity to the active runbook. Double-click the Get Data Source activity icon.

  2. On the Properties tab, click the ellipsis button (...), and select the Name of the Data Protection Manager computer that you want to connect to for this activity.

  3. In the Properties section, select the Data Source Location that you want to use for this activity, and enter the Name of the target that you want to query.

  4. By default, all data sources including Hyper-V, SharePoint, SQL, and System Protection are returned. To filter the returned data sources, click the Filters tab. In the Filters section, click Add. In the Name box, click the down arrow and select an item from the list that you want to use to define this runbook.

  5. In the Relation box, click the down arrow and select a relationship descriptor for the filter.

  6. In the Value box, click the ellipsis button (...) and select a value to be applied to this filter. If the ellipsis button does not appear for the filter you have selected, enter the value you want to use, and then click OK.

    If applicable, to automatically populate the value for a filter from the data published by any previous activity in the runbook, right-click the Value box, Point to Subscribe, and then click Published data. Click the published data element you want to use, and then click OK.

  7. Add additional filters as needed.

  8. To make changes to a filter, click the filter and then click Edit. Make the necessary changes, and then click OK. To remove a filter, click the filter and then click Remove.

  9. For information about the settings on the General and Run Behavior tabs, see Common Configuration Instructions for all Activities.

  10. Click Finish.

Other Activities

The Integration Pack for Data Protection Manager contains the following additional activities: