This topic has not yet been rated - Rate this topic

Get-DPMDatasource

Updated: January 14, 2013

Applies To: System Center 2012 - Data Protection Manager

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 the objects at whose level protection can be done. Use the Get-ChildDatasource cmdlet to see files within the data source.

- Using the Inquire parameter returns all the available data sources on the protected computer.

- Use the DPMServerName parameter with a search string to search for a protected data source on a DPM server.

- Use the Inactive parameter to return all the inactive data sources on a DPM server. An inactive data source is one that is not actively protected on a DPM server.

- Use the ProtectionGroup parameter to return the data sources in a protection group.

Parameters

-Async

Allows the user to indicate that the cmdlet should run asynchronously. This is useful with cmdlets that take a long time to complete. The control returns to the user immediately after the operation starts. The progress of the operation is communicated to the user periodically. This is useful when building a GUI using cmdlets. It is not used when working with the DPM Management Shell.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ComputerName<String[]>

Provide the list of client computers to be added to the protection group.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	True (ByValue, ByPropertyName)
Accept Wildcard Characters?	false

-DPMServerName<String>

Provide the name of the DPM server.

Aliases	none
Required?	false
Position?	1
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-GetVolumesWithoutMountPoints

Indicates that even volumes without mount points must be retrieved.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-IgnoreDPMInformation

Indicates that the cmdlet should 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 inactive data sources on a DPM server must be returned. An inactive data source is one which was protected on the DPM server at one time but is not protected currently. The replicas and recovery points of an inactive data source will still be available.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Inquire

Queries the protected computer and returns the list of 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>

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

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ProductionServer<ProductionServer>

Provide a server that has a DPM agent installed on it.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	True (ByValue, ByPropertyName)
Accept Wildcard Characters?	false

-ProductionServerName<String>

Specify the name of the server being protected.

Aliases	none
Required?	false
Position?	3
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ProtectionGroup<ProtectionGroup>

Specify the name of a protection group.

Aliases	none
Required?	true
Position?	1
Default Value	none
Accept Pipeline Input?	True (ByValue, ByPropertyName)
Accept Wildcard Characters?	false

-Query<String>

Filters the list of data sources and returns only the ones where the name contains the specified string.

Aliases	none
Required?	true
Position?	2
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Replica

Indicates whether the space required for a replica on the secondary DPM server should be calculated 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>

Indicates that replies to each asynchronous call made by a cmdlet. This is useful when building a GUI using cmdlets.

It is not used when working 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.

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

For technical information, type "Get-Help Get-DPMDatasource -full".

Examples

-------------------------- EXAMPLE 1 --------------------------

This command returns the list of all data sources on a computer.

PowerShell

PS C:\>$ps = Get-ProductionServer -DPMServerName TestingServerGet-DPMDatasource -ProductionServer $ps[1] -Inquire

-------------------------- EXAMPLE 2 --------------------------

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

PowerShell

PS C:\>$pg = Get-ProtectionGroup -DPMServerName TestingServerGet-DPMDatasource -ProtectionGroup $pg

-------------------------- EXAMPLE 3 --------------------------

This command retrieves the inactive data sources on a server.

PowerShell

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

-------------------------- EXAMPLE 4 --------------------------

This command retrieves the data source from the specified search location.

PowerShell

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

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)