Get-DPMRecoverableItem
Get-DPMRecoverableItem
Gets a list of recoverable items in a recovery point.
Syntax
Parameter Set: Browse
Get-DPMRecoverableItem [-RecoverableItem] <RecoverableObject> [-BrowseType] <BrowseType> [-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. The recoverable items based on source are:
-- File system: Files and folders
-- Microsoft Exchange: Storage groups, databases and mailboxes
-- Microsoft SQL: 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<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
Aliases |
none |
Required? |
true |
Position? |
2 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
-Datasource<Datasource>
Specifies an array of data source objects. Data source objects include the following:
-- Windows file system share or volume.
-- Microsoft SQL Server database.
-- Microsoft Exchange storage group.
-- Microsoft SharePoint farm.
-- Microsoft Virtual Machine.
-- DPM database.
-- A 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 child item within a recovery point that is recoverable. For example, a Windows file system share or volume, a Microsoft SQL database, a Microsoft Exchange storage group, Microsoft SharePoint, 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.
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
Notes
- For more information, type "
Get-Help Get-DPMRecoverableItem -detailed
".
Examples
Example 1: Get a recoverable item in a recovery point
This example gets a list of recoverable items in the parent and child nodes of a recovery point.
The first command gets the protection group on the DPM server named DPMServer02 and stores the results in the $Pg variable.
The second command gets the list of protected and unprotected data in the protection group stored in the $Pg variable. The command stores the result in the $Ds variable.
The third command gets the recovery point for the protection group stored in the $Ds variable, and stores the result in the $Rp variable.
The fourth command gets the recoverable items in the parent and child nodes of the recovery point stored in $Rp.
PS C:\> $Pg = Get-DPMProtectionGroup -DPMServerName "DPMServer02"
PS C:\> $Ds = Get-DPMDatasource -ProtectionGroup $Pg
PS C:\> $Rp = Get-DPMRecoveryPoint -Datasource $Ds
PS C:\> Get-DPMRecoverableItem -RecoverableItem $Rp -BrowseType child