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