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