Get-DPMDatasource

Get-DPMDatasource

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

Syntax

Parameter Set: DpmServer
Get-DPMDatasource [[-DPMServerName] <String> ] [-Inactive] [ <CommonParameters>]

Parameter Set: ClientProtectionGroup
Get-DPMDatasource [[-DPMServerName] <String> ] [-ComputerName] <String[]> [-Async] [ <CommonParameters>]

Parameter Set: DataSourceSearch
Get-DPMDatasource [[-DPMServerName] <String> ] [-Query] <String> [ <CommonParameters>]

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

Parameter Set: ProtectionGroup
Get-DPMDatasource [-ProtectionGroup] <ProtectionGroup> [ <CommonParameters>]

Parameter Set: Search
Get-DPMDatasource [[-DPMServerName] <String> ] [-Path] <String> [[-ProductionServerName] <String> ] [ <CommonParameters>]

Detailed Description

The Get-DPMDatasource cmdlet gets the protected and unprotected data on a computer in System Center 2012 – 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:

-- 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.

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ComputerName<String[]>

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

Aliases

ComputerNames

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-DPMServerName<String>

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

Aliases

none

Required?

false

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-GetVolumesWithoutMountPoints

Indicates that the cmdlet retrieves volumes without mount points.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-IgnoreDPMInformation

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Inquire

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Path<String>

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

Aliases

SearchPath

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProductionServer<ProductionServer>

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

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-ProductionServerName<String>

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

Aliases

none

Required?

false

Position?

3

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-ProtectionGroup<ProtectionGroup>

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

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

True (ByValue, ByPropertyName)

Accept Wildcard Characters?

false

-Query<String>

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

Aliases

SearchQuery

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

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.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Tag<Object>

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.

Aliases

none

Required?

false

Position?

named

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.

  • Datasource

Examples

Example 1: Return all data sources on a computer

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.

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

Example 2: Return protected data sources in a protection group

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.

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

Example 3: Return inactive data sources on a server

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

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

Example 4: Get a data source from a search location

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

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

Get-DPMProtectionGroup

Get-DPMProductionServer