Share via

Get-DPMDatasource

Module:
DataProtectionManager Module

Gets protected and unprotected data in a computer or protection group.

Syntax

DpmServer (Default) 

Get-DPMDatasource
    [[-DPMServerName] <String>]
    [-Inactive]
    [<CommonParameters>]

DataSourceSearch 

Get-DPMDatasource
    [[-DPMServerName] <String>]
    [-Query] <String>
    [<CommonParameters>]

Get-DPMDatasource
    [[-DPMServerName] <String>]
    [-Path] <String>
    [[-ProductionServerName] <String>]
    [<CommonParameters>]

ClientProtectionGroup 

Get-DPMDatasource
    [[-DPMServerName] <String>]
    [-ComputerName] <String[]>
    [-Async]
    [<CommonParameters>]

ProductionServer 

Get-DPMDatasource
    [-ProductionServer] <ProductionServer>
    [-Async]
    [-Inquire]
    [-Replica]
    [-Tag <Object>]
    [-IgnoreDPMInformation]
    [-GetVolumesWithoutMountPoints]
    [<CommonParameters>]

ProtectionGroup 

Get-DPMDatasource
    [-ProtectionGroup] <ProtectionGroup>
    [<CommonParameters>]

Description

The Get-DPMDatasource cmdlet gets the protected and unprotected data on a computer in System Center - Data Protection Manager (DPM). The output displays only objects at levels that allow you to apply protection. Use the Get-DPMChildDatasource cmdlet to see files in the data source.

This cmdlet can also return the following information about the data on the computer.

The acceptable values for this parameter are:

  • All available data sources on the protected computer.
  • Protected data source on a DPM server.
  • Inactive data sources on a DPM server. An inactive data source is one that is not actively protected on a DPM server.
  • Data sources in a protection group.

Examples

Example 1: Return all data sources on a computer

PS C:\>$DpmPServer = Get-DPMProductionServer -DPMServerName "TestingServer"
PS C:\> Get-DPMDatasource -ProductionServer $DpmPServer[1] -Inquire

The first command returns the servers that have DPM Protection Agent installed, and then stores them in the $DpmPServer variable.

The second command gets the data sources on the second server in $DpmPServer.

Example 2: Return protected data sources in a protection group

PS C:\> $DpmPServer = Get-DPMProtectionGroup -DPMServerName "TestingServer"
PS C:\> Get-DPMDatasource -ProtectionGroup $DpmPServer

The first command returns the protection group from the DPM server named TestingServer. The command stores the group in the $DpmPServer variable.

The second command returns the data sources from the protection group in $DpmPServer.

Example 3: Return inactive data sources on a server

PS C:\> Get-DPMDatasource -DPMServerName "TestingServer" -Inactive

This command retrieves the inactive data sources on the DPM server named TestingServer.

Example 4: Get a data source from a search location

PS C:\> Get-DPMDatasource -DPMServerName "TestingServer" -SearchPath "F:\" -ProductionServer "Test.contoso.com"

This command retrieves a data source from the search path F:\ on the protected server Test.contoso.com.

Parameters

-Async

Indicates that the command runs asynchronously. When you run a command asynchronously, the command prompt returns immediately even if the job takes an extended time to finish.

Parameter properties

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

Parameter sets

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

-ComputerName

Specifies an array of client computers that you add to the protection group.

Parameter properties

Type:

String[]

Default value:None
Supports wildcards:False
DontShow:False
Aliases:ComputerNames

Parameter sets

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

-DPMServerName

Specifies the name of the DPM server on which this cmdlet acts.

Parameter properties

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

Parameter sets

DpmServer
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
DataSourceSearch
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
Search
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False
ClientProtectionGroup
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-GetVolumesWithoutMountPoints

Indicates that the cmdlet retrieves volumes without mount points.

Parameter properties

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

Parameter sets

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

-IgnoreDPMInformation

Indicates that the cmdlet does not retrieve protected computer information for data sources.

Parameter properties

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

Parameter sets

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

-Inactive

Indicates that the cmdlet returns inactive data sources on a DPM server. An inactive data source is one that was protected on the DPM server at one time but is not protected currently. The replicas and recovery points of an inactive data source remain available.

Parameter properties

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

Parameter sets

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

-Inquire

Indicates that this cmdlet queries the protected computer and returns the data sources or child data sources on it.

Parameter properties

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

Parameter sets

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

-Path

Specifies the path on which to search for the data source.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SearchPath

Parameter sets

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

-ProductionServer

Specifies a computer on which a DPM protection agent is installed.

Parameter properties

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

Parameter sets

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

-ProductionServerName

Specifies the name of a computer on which a DPM protection agent is installed.

Parameter properties

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

Parameter sets

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

-ProtectionGroup

Specifies the a protection group on which this cmdlet acts. To obtain a ProtectionGroup object, use the Get-DPMProtectionGroup cmdlet.

Parameter properties

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

Parameter sets

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

-Query

Specifies a filter for of the data sources. This cmdlet returns only the ones that have names that contain the specified string.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False
Aliases:SearchQuery

Parameter sets

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

-Replica

Indicates that this cmdlet calculates the space that is required for a replica on the secondary DPM server from the protected computer or the primary DPM server.

Parameter properties

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

Parameter sets

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

-Tag

Specifies a custom property that distinguishes the replies to each asynchronous call. You can use parameter if you build a graphical user interface by using cmdlets. Do not use this parameter if you work with the DPM Management Shell.

Parameter properties

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

Parameter sets

ProductionServer
Position:Named
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.

Outputs

Datasource