Get-DPMRecoverableItem

Gets a list of recoverable items in a recovery point.

Syntax

Get-DPMRecoverableItem
   [-RecoverableItem] <RecoverableObject>
   [-BrowseType] <BrowseType>
   [-Async]
   [-Tag <Object>]
   [<CommonParameters>]
Get-DPMRecoverableItem
   -RecoveryPointForShares <RecoverySource>
   [-Async]
   [-Tag <Object>]
   [<CommonParameters>]
Get-DPMRecoverableItem
   [-Datasource] <Datasource>
   [-SearchOption] <SearchSpecifications>
   [-Async]
   [-Tag <Object>]
   [<CommonParameters>]

Description

The Get-DPMRecoverableItem cmdlet gets a list of recoverable items in a recovery point for System Center - 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

Examples

Example 1: Get a recoverable item in a recovery point

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

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.

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BrowseType

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

The acceptable values for this parameter are:

  • Parent
  • Child
Type:BrowseType
Accepted values:Child, Parent
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

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

Type:Datasource
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RecoverableItem

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.

Type:RecoverableObject
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-RecoveryPointForShares

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

Type:RecoverySource
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SearchOption

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

Type:SearchSpecifications
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:Object
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

RecoverableItem