Get-DPMRecoverableItem

Get-DPMRecoverableItem

Gets a list of recoverable items in a recovery point.

Syntax

Parameter Set: Browse
Get-DPMRecoverableItem [-RecoverableItem] <RecoverableObject> [-BrowseType] <DbEnums+BrowseType> {Child | Parent} [-Async] [-Tag <Object> ] [ <CommonParameters>]

Parameter Set: Search
Get-DPMRecoverableItem [-Datasource] <Datasource> [-SearchOption] <SearchSpecifications> [-Async] [-Tag <Object> ] [ <CommonParameters>]

Parameter Set: Shares
Get-DPMRecoverableItem -RecoveryPointForShares <RecoverySource> [-Async] [-Tag <Object> ] [ <CommonParameters>]

Detailed Description

The Get-DPMRecoverableItem cmdlet gets a list of recoverable items in a recovery point for System Center 2012 – Data Protection Manager (DPM). The recoverable items based on source are as follows:

-- File system: Files and folders
-- Microsoft Exchange Server: Storage groups, databases, and mailboxes
-- Microsoft SQL Server: Databases
-- Microsoft SharePoint: Sites, databases, and documents
-- Virtual Machines
-- A DPM server
-- System state of a protected computer

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

-BrowseType<DbEnums+BrowseType>

Specifies whether to browse only the parent nodes in a recovery point, or to browse the parent nodes and the child nodes. Valid values are:

-- Parent
-- Child

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Datasource<Datasource>

Specifies a data source object for which this cmdlet gets recoverable items. A data source can be a file system share or volume for the Windows operating system, Microsoft SQL Server database, Microsoft Exchange Server storage group, Microsoft SharePoint farm, Microsoft Virtual Machine, DPM database, or system state that is a member of a protection group.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-RecoverableItem<RecoverableObject>

Specifies a recoverable item object. This is a child item in a recovery point that is recoverable. Examples include the following: a file system share or volume, a Microsoft SQL Server database, a Microsoft Exchange Server storage group, Microsoft SharePoint Site, Microsoft Virtual Machine, a Microsoft DPM database, system state or a recovery point.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-RecoveryPointForShares<RecoverySource>

Specifies a recovery point object. To obtain a recovery point object, use the Get-DPMRecoveryPoint cmdlet.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

true (ByValue)

Accept Wildcard Characters?

false

-SearchOption<SearchSpecifications>

Specifies the search options. You can use the New-DPMSearchOption cmdlet to create an object that specifies search options for recoverable objects.

Aliases

none

Required?

true

Position?

2

Default Value

none

Accept Pipeline Input?

true (ByValue)

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.

  • RecoverableItem

Examples

Example 1: Get a recoverable item in a recovery point

The first command gets the protection group on the DPM server named DPMServer02, and then stores the group in the $PGroup variable.

The second command gets the list of protected and unprotected data in the protection group in $PGroup. The command stores the result in the $PObjects variable.

The third command gets the recovery point for the protection group in $PObjects variable, and then stores the recovery point in the $RPoint variable.

The final command gets the recoverable items in the parent and child nodes of the recovery point in $RPoint.

PS C:\> $PGroup = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $PObjects = Get-DPMDatasource -ProtectionGroup $PGroup
PS C:\> $RPoint = Get-DPMRecoveryPoint -Datasource $PObjects
PS C:\> Get-DPMRecoverableItem -RecoverableItem $RPoint -BrowseType Child

Get-DPMProtectionGroup

Get-DPMRecoveryPoint

New-DPMSearchOption

Restore-DPMRecoverableItem

Get-DPMDatasource