Get-DPMDatasource

Get-DPMDatasource

Retrieves the list of 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 retrieves the list of protected and unprotected data on a computer. The output displays only objects at levels that allow you to apply protection. Use the Get-ChildDatasource cmdlet to see files within 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 System Center 2012 – Data Protection Manager (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 cmdlet runs asynchronously. When you specify this parameter, the cmdlet returns control to you immediately after the operation starts and periodically reports on the progress of the operation. This parameter is useful if the cmdlet takes a long time to complete or if you build a graphical user interface (GUI) by using cmdlets. Do not use this parameter if you are working with the DPM Management Shell.

-ComputerName<String[]>

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

-DPMServerName<String>

Specifies the name of the DPM server.

-GetVolumesWithoutMountPoints

Indicates that the cmdlet retrieves volumes without mount points.

-IgnoreDPMInformation

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

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

-Inquire

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

-Path<String>

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

-ProductionServer<ProductionServer>

Specifies a server that has DPM Protection Agent installed.

-ProductionServerName<String>

Specifies the name of the server that you protect.

-ProtectionGroup<ProtectionGroup>

Specifies the name of a protection group.

-Query<String>

Filters the list of data sources and returns only the ones whose names contain the specified string.

-Replica

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

-Tag<Object>

Specifies a custom property that distinguishes the replies to each asynchronous call.

Do not use this parameter if you work with the DPM Management Shell.

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://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

Notes

• For more information, type "Get-Help Get-DPMDatasource -detailed ".

Examples

Example 1: Return all data sources on a computer

This example returns a list of all data sources on a computer.

The first command returns a list of servers that have DPM Protection Agent installed, and stores the list in the variable named $Ps.

The second command returns the list of data sources on the second server (at position 1) in the $Ps variable.

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

Example 2: Return protected data sources in a protection group

This example retrieves the protected data sources in the specified protection group.

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

The second command returns the list of data sources from the protection group in $Pg.

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

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"