Chat now with support
Chat mit Support

Recovery Manager for AD Disaster Recovery Edition 10.2 - User Guide

Overview Getting started
Permissions required to use Recovery Manager for Active Directory Recovery Manager Console Getting and using help Configuring Windows Firewall Using Computer Collections Secure Storage servers Managing Recovery Manager for Active Directory configuration Licensing
Backing up data
Permissions required for the Backup operation Managing Backup Agent Using a least-privileged user account to back up data Using Managed Service Accounts Active Directory backups vs Windows System State backups Creating BMR and Active Directory backups Using the Backup Wizard Retrying backup creation Enabling backup encryption Backing up AD LDS (ADAM) Backing up cross-domain group membership Backing up distributed file system (DFS) data Backup scheduling Setting performance options Setting advanced backup options Using Forest Recovery Agent Unpacking backups Using e-mail notification Viewing backup creation results
Restoring data
Getting started with Active Directory recovery Managing deleted or recycled objects Restoring backed up Active Directory components Integration with Change Auditor for Active Directory Using granular online restore Restoring AD LDS (ADAM) Selectively restoring Active Directory object attributes Restoring objects in an application directory partition Restoring object quotas Restoring cross-domain group membership Performing a restore without having administrator privileges Reports about objects and operations Using complete offline restore Offline restore implications Restoring SYSVOL authoritatively Performing a granular restore of SYSVOL Recovering Group Policy Restoring data from third-party backups Using the Extract Wizard Restoring passwords and SID history
Full Replication Consolidating backup registration data Monitoring Recovery Manager for Active Directory Recovering an Active Directory forest
Forest recovery overview Deploying Recovery Manager for Active Directory Forest Edition (Disaster Recovery Edition) Permissions required to use Forest Recovery Console Forest Recovery Console Managing a recovery project Recovery methods Phased recovery Managing Forest Recovery Agent Rebooting domain controllers manually Resetting DSRM Administrator Password Purging Kerberos Tickets Managing the Global Catalog servers Managing FSMO roles Manage DNS Client Settings Configuring Windows Firewall Developing a custom forest recovery plan Backing up domain controllers Assigning a preferred DNS server during recovery Handling DNS servers during recovery Forest recovery approaches Deciding which backups to use Running custom scripts while recovering a forest Overview of steps to recover a forest Viewing forest recovery progress Viewing recovery plan Viewing a report about forest recovery or verify settings operation Handling failed domain controllers Adding a domain controller to a running recovery operation Selectively recovering domains in a forest Recovering SYSVOL Deleting domains during recovery Resuming an interrupted forest recovery Recovering read-only domain controllers (RODCs) Checking forest health Collecting diagnostic data for technical support
Restore Active Directory on Clean OS Bare metal forest recovery Using Management Shell Creating virtual test environments Using Recovery Manager for Active Directory web portal Appendices
Frequently asked questions Best practices for using Computer Collections Technical characteristics Best practices for creating backups Best practices for creating backups for forest recovery Best practices for recovering a forest Descriptions of recovery or verification steps Ports Used by Recovery Manager for Active Directory Forest Edition (Disaster Recovery Edition) Backup Wizard Online Restore Wizard Online Restore Wizard for AD LDS (ADAM) Group Policy Restore Wizard Repair Wizard Extract Wizard Events generated by Recovery Manager for Active Directory Descriptions of PowerShell commands
Add-RMADBackup Add-RMADCollectionItem Add-RMADReplicationConsole Add-RMADStorageServer Backup-RMADCollection Close-RMADFEProject Compare-RMADObject Convert-RMADBackup ConvertTo-RMADRecycledObject Copy-RMADFEBackup Create-RMADStorageAgentSetup Expand-RMADBackup Export-RMADBackup Export-RMADFERecoveryCertificate Export-RMADFEResult Export-RMADSecureStorageBackup Get-RMADBackup Get-RMADBackupAgent Get-RMADBackupInfo Get-RMADBackupObject Get-RMADBackupSecurityStatus Get-RMADCollection Get-RMADCollectionItem Get-RMADDeletedObject Get-RMADFEAvailableSubnet Get-RMADFEComputer Get-RMADFEConsole Get-RMADFEDnsCache Get-RMADFEDomain Get-RMADFEEvent Get-RMADFEGlobalOptions Get-RMADFEOperation Get-RMADFEPersistenceConnection Get-RMADFEProject Get-RMADFERecoveryAgent Get-RMADFESchedule Get-RMADGlobalOptions Get-RMADLicenseInfo Get-RMADObject Get-RMADReplicationConsole Get-RMADReplicationSchedule Get-RMADReplicationSession Get-RMADReplicationSessionItem Get-RMADReportObject Get-RMADReportObjectAttributes Get-RMADReportObjectChildren Get-RMADReportSession Get-RMADSession Get-RMADSessionItem Get-RMADSessionItemEvent Get-RMADStorageServer Get-RMADStorageServerHardeningStatus Get-RMADStorageServerRetentionPolicy Import-RMADBackup Import-RMADFERecoveryCertificate Install-RMADBackupAgent Install-RMADFERecoveryAgent New-RMADCollection New-RMADFEProject New-RMADFERecoveryMedia New-RMADSchedule Open-RMADFEProject Protect-RMADSecureStorageServer Protect-RMADStorageServer Publish-RMADBackupSecurityStatus Refresh-RMADStorageServer Register-RMADSecureStorageBackups Remove-RMADBackup Remove-RMADBackupAgent Remove-RMADCollection Remove-RMADCollectionItem Remove-RMADFERecoveryAgent Remove-RMADFESchedule Remove-RMADReplicationConsole Remove-RMADReplicationSchedule Remove-RMADReplicationSession Remove-RMADStorageServer Remove-RMADUnpackedComponent Rename-RMADCollection Restore-RMADDeletedObject Restore-RMADDomainController Restore-RMADObject Resume-RMADFERecovery Save-RMADFEProject Set-RMADCollection Set-RMADFEComputer Set-RMADFEDnsCache Set-RMADFEDomain Set-RMADFEGlobalOptions Set-RMADFEPersistenceConnection Set-RMADFERecoveryMode Set-RMADFESchedule Set-RMADGlobalOptions Set-RMADReplicationConsole Set-RMADReplicationSchedule Set-RMADStorageServerRetentionPolicy Start-RMADFERecovery Start-RMADFERecoveryAgentOperation Start-RMADFEVerification Start-RMADReplication Start-RMADReportViewer Stop-RMADFEWorkflow Test-RMADSecureStorageBackup Unprotect-RMADStorageServer Update-RMADBackupAgent Update-RMADFEProject Update-RMADLicense

Get-RMADBackup


external help file: QuestSoftware.RecoveryManager.AD.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:

schema: 2.0.0

SYNOPSIS

Gets backups registered with Recovery Manager.

SYNTAX

Id (Default)

Get-RMADBackup [-MinimumId <Int32>] [-Domain <String>] [-All] [[-Id] <Int32[]>] [-ComputerName <String>]
 [-MaxDate <DateTime>] [-MinDate <DateTime>] [-Site <String>] [-CollectionId <Int32>]
 [-BackupComponents <BackupComponents>] [-IncludeDeleted] [-AfterModifiedDate <DateTime>] [-First <Int32>]
 [-Skip <Int32>] [-SourceConsole <String>] [-InformationAction <ActionPreference>]
 [-InformationVariable <String>] [<CommonParameters>]

Id_IncludeSecureStorage

Get-RMADBackup [-MinimumId <Int32>] [-Domain <String>] [-All] [-Id] <Int32[]> [-ComputerName <String>]
 [-MaxDate <DateTime>] [-MinDate <DateTime>] [-Site <String>] [-CollectionId <Int32>]
 [-BackupComponents <BackupComponents>] [-IncludeDeleted] [-IncludeSecureStorage]
 [-AfterModifiedDate <DateTime>] [-First <Int32>] [-Skip <Int32>] [-SourceConsole <String>]
 [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

Id_OnlySecureStorage

Get-RMADBackup [-MinimumId <Int32>] [-Domain <String>] [-All] [-Id] <Int32[]> [-ComputerName <String>]
 [-MaxDate <DateTime>] [-MinDate <DateTime>] [-Site <String>] [-CollectionId <Int32>]
 [-BackupComponents <BackupComponents>] [-IncludeDeleted] [-OnlySecureStorage] [-AfterModifiedDate <DateTime>]
 [-First <Int32>] [-Skip <Int32>] [-SourceConsole <String>] [-InformationAction <ActionPreference>]
 [-InformationVariable <String>] [<CommonParameters>]

Guid

Get-RMADBackup [-MinimumId <Int32>] [-Domain <String>] [-All] [[-Guid] <Guid[]>] [-ComputerName <String>]
 [-MaxDate <DateTime>] [-MinDate <DateTime>] [-Site <String>] [-CollectionId <Int32>]
 [-BackupComponents <BackupComponents>] [-IncludeDeleted] [-AfterModifiedDate <DateTime>] [-First <Int32>]
 [-Skip <Int32>] [-SourceConsole <String>] [-InformationAction <ActionPreference>]
 [-InformationVariable <String>] [<CommonParameters>]

Guid_IncludeSecureStorage

Get-RMADBackup [-MinimumId <Int32>] [-Domain <String>] [-All] [-Guid] <Guid[]> [-ComputerName <String>]
 [-MaxDate <DateTime>] [-MinDate <DateTime>] [-Site <String>] [-CollectionId <Int32>]
 [-BackupComponents <BackupComponents>] [-IncludeDeleted] [-IncludeSecureStorage]
 [-AfterModifiedDate <DateTime>] [-First <Int32>] [-Skip <Int32>] [-SourceConsole <String>]
 [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

Guid_OnlySecureStorage

Get-RMADBackup [-MinimumId <Int32>] [-Domain <String>] [-All] [-Guid] <Guid[]> [-ComputerName <String>]
 [-MaxDate <DateTime>] [-MinDate <DateTime>] [-Site <String>] [-CollectionId <Int32>]
 [-BackupComponents <BackupComponents>] [-IncludeDeleted] [-OnlySecureStorage] [-AfterModifiedDate <DateTime>]
 [-First <Int32>] [-Skip <Int32>] [-SourceConsole <String>] [-InformationAction <ActionPreference>]
 [-InformationVariable <String>] [<CommonParameters>]

IncludeSecureStorage

Get-RMADBackup [-MinimumId <Int32>] [-Domain <String>] [-All] [-ComputerName <String>] [-MaxDate <DateTime>]
 [-MinDate <DateTime>] [-Site <String>] [-CollectionId <Int32>] [-BackupComponents <BackupComponents>]
 [-IncludeDeleted] [-IncludeSecureStorage] [-AfterModifiedDate <DateTime>] [-First <Int32>] [-Skip <Int32>]
 [-SourceConsole <String>] [-InformationAction <ActionPreference>] [-InformationVariable <String>]
 [<CommonParameters>]

OnlySecureStorage

Get-RMADBackup [-MinimumId <Int32>] [-Domain <String>] [-All] [-ComputerName <String>] [-MaxDate <DateTime>]
 [-MinDate <DateTime>] [-Site <String>] [-CollectionId <Int32>] [-BackupComponents <BackupComponents>]
 [-IncludeDeleted] [-OnlySecureStorage] [-AfterModifiedDate <DateTime>] [-First <Int32>] [-Skip <Int32>]
 [-SourceConsole <String>] [-InformationAction <ActionPreference>] [-InformationVariable <String>]
 [<CommonParameters>]

DESCRIPTION

Retrieves the backup object for the backups registered in the Recovery Manager backup registration database.

EXAMPLES

Example 1

PS C:\> Get-RMADBackup | Where-Object {$_.ComputerName -eq "dc1.dom1.local"}

This command retrieves all backup objects and passes them to the Where-Object cmdlet.
The Where-Object cmdlet outputs the backup objects whose ComputerName property value is dc1.dom1.local.

Example 2

PS C:\> Get-RMADBackup -Id 12345

Retrieves the backup whose identifier is 12345.

Example 3

PS C:\> Get-RMADBackup | Where-Object {($_.Date -gt (Get-Date).AddDays(-5)) -and ($_.Path -like "*Toronto*")}

This command retrieves objects that represent backups created by Recovery Manager for Active Directory in the last 5 days.
The command retrieves only those backups whose file path includes the word "Toronto".

Example 4

PS C:\> Get-RMADBackup -Skip 10 -First 100

This command skips the first 10 backups and starts retrieving 100 backups from the 11th one.

PARAMETERS

-MinimumId

Retrieves backups with identifier greater than a specified number.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Domain

Retrieves the backup objects for the specified domain only.
If this parameter is not specified, all backup objects are retrieved from the Recovery Manager backup registration database.

Type: String
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-All

When this parameter is present, the cmdlet gets all backup objects registered in the Recovery Manager backup registration database, including those whose file is physically missing.
When this parameter is omitted, the cmdlet gets only those backup objects registered in the Recovery Manager backup registration database whose file is physically present.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Id

Specifies the identifier of the backup to get.

Type: Int32[]
Parameter Sets: Id
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: Int32[]
Parameter Sets: Id_IncludeSecureStorage, Id_OnlySecureStorage
Aliases:

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

-ComputerName

Retrieves the backup objects from the specified computer only.

Type: String
Parameter Sets: (All)
Aliases:

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

-MaxDate

Retrieves the backup objects after the specified date.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-MinDate

Retrieves the backup objects before the specified date.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-Site

Retrieves the backup objects from the specified AD site

Type: String
Parameter Sets: (All)
Aliases:

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

-CollectionId

Retrieves the backup objects for the specified collection only.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-BackupComponents

Retrieves the backup objects with the specified components only.
If
this parameter is not specified, all backup objects are retrieved from
the Recovery Manager backup registration database.

Type: BackupComponents
Parameter Sets: (All)
Aliases:

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

-IncludeDeleted

When this parameter is present, the cmdlet gets all backup objects from the Recovery Manager backup registration database, including those objects whose status has been marked as Deleted or Unregistered.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-AfterModifiedDate

Retrieves the backup objects that were last modified after this date.

Type: DateTime
Parameter Sets: (All)
Aliases:

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

-First

Specifies the number of backups to retrieve.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-Skip

Specifies the number of backups to skip before starting retrieving.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-SourceConsole

Retrieves backups replicated from a specified console.

Type: String
Parameter Sets: (All)
Aliases:

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

-Guid

Specifies the GUID of the backup to get.

Type: Guid[]
Parameter Sets: Guid
Aliases:

Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: Guid[]
Parameter Sets: Guid_IncludeSecureStorage, Guid_OnlySecureStorage
Aliases:

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

-InformationAction

@{Text=}

Type: ActionPreference
Parameter Sets: (All)
Aliases: infa

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

-InformationVariable

@{Text=}

Type: String
Parameter Sets: (All)
Aliases: iv

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

-OnlySecureStorage

Return backups stored on a Secure Storage servers.

Type: SwitchParameter
Parameter Sets: Id_OnlySecureStorage, Guid_OnlySecureStorage
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: SwitchParameter
Parameter Sets: OnlySecureStorage
Aliases:

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

-IncludeSecureStorage

When this parameter is present, the cmdlet gets all backup objects from the Recovery Manager backup registration database, including backups stored on Secure Storage servers.

Type: SwitchParameter
Parameter Sets: Id_IncludeSecureStorage, Guid_IncludeSecureStorage
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: SwitchParameter
Parameter Sets: IncludeSecureStorage
Aliases:

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS

 

Get-RMADBackupAgent


external help file: QuestSoftware.RecoveryManager.AD.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:

schema: 2.0.0

SYNOPSIS

Retrieves objects that represent Recovery Manager Backup Agents, or discovers manually preinstalled Recovery Manager Backup Agents.

SYNTAX

Get-RMADBackupAgent [-Discover] [-UpdateInfo] [-InformationAction <ActionPreference>]
 [-InformationVariable <String>] [<CommonParameters>]

DESCRIPTION

Allows you to retrieve a list of installed and registered in the Recovery Management Console Backup Agents.
It also allows you to discover all Backup Agent instances that were manually preinstalled on computers.

EXAMPLES

Example 1

PS C:\> Get-RMADBackupAgent

This code returns a list of installed and registered in the Recovery Management Console Backup Agents.

Example 2

PS C:\> Get-RMADBackupAgent -Discover

This code discovers all Backup Agent instances that were manually
preinstalled on computers.
Note that after the discover operation completes, you can
view and manage the discovered Backup Agent instances using the corresponding cmdlets or from the Backup Agent Management node in the Recovery Manager Console.

PARAMETERS

-Discover

Specifies whether Backup Agent instances that were manually preinstalled on computers should be discovered.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-UpdateInfo

Specifies whether Backup Agents information should be re-requested.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-InformationAction

@{Text=}

Type: ActionPreference
Parameter Sets: (All)
Aliases: infa

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

-InformationVariable

@{Text=}

Type: String
Parameter Sets: (All)
Aliases: iv

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS

 

Get-RMADBackupInfo


external help file: QuestSoftware.RecoveryManager.AD.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:

schema: 2.0.0

SYNOPSIS

Gets the content of the backups held at a specified location.

SYNTAX

Bkf

Get-RMADBackupInfo [-Path] <String[]> [-BackupPassword <SecureString>] [-UseLegacyEncryption] [-IgnoreReadOnly]
 [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

OfflineDit

Get-RMADBackupInfo [-Path] <String[]> [-SysvolPath <String[]>] [-ResolveIndexes <Boolean>] [-OfflineDit]
 [-IgnoreReadOnly] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

BackupInfo

Get-RMADBackupInfo [-BackupPassword <SecureString>] [-UseLegacyEncryption] [-IgnoreReadOnly]
 [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

DESCRIPTION

The Get-RMADBackupInfo cmdlet gets the content of the backups created with Recovery Manager and held at the location specified by the path.

EXAMPLES

Example 1

PS C:\> $b = Get-ChildItem C:\Backups -Filter *.bkf -Recurse | Get-RMADBackupInfo

C:\PS>Where-Object -InputObject $b { $_.Contents -band 64 } | Add-RMADBackup

This command gets the content of all backups held in the C:\Backups folder and its subfolders, and saves the content in the $b variable.
The Where-Object cmdlet then passes the Active Directory backups from the $b variable to the Add-Backup cmdlet (the number 64 stands for the Active Directory component.) Add-RMADBackup then registers the passed Active Directory backups in the Recovery Manager database.

Example 2

PS C:\> $p = Read-Host "Backup Password" -AsSecureString

C:\PS>Get-RMADBackupInfo C:\Backups\password-protected_backup1.bkf -BackupPassword $p

In this example, the Read-Host cmdlet provided by Windows PowerShell gets the backup password as a SecureString object and saves it in the $p variable.
The Get-RMADBackupInfo then uses the password saved in the $p variable to access the password-protected backup C:\Backups\password-protected_backup1.bkf.

PARAMETERS

-Path

Specifies the path to the backups whose content is to be retrieved.

Type: String[]
Parameter Sets: Bkf, OfflineDit
Aliases: FullName

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-BackupPassword

Specifies the password to access a password-protected backup.
This is the same password that is set in the computer collection properties in the Recovery Manager console.

Type: SecureString
Parameter Sets: Bkf, BackupInfo
Aliases:

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

-UseLegacyEncryption

Allows you to work with backups encrypted by the RC4 algorithm from RSA, Inc.
(Microsoft RSA Base Provider).
This algorithm is used to back up Windows Server 2003/2003 R2 domain controllers in Recovery Manager for Active Directory 8.2.x and 8.5.x.

Type: SwitchParameter
Parameter Sets: Bkf, BackupInfo
Aliases:

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

-IgnoreReadOnly

Allows you to perform the action in a console currently performing full replication.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-SysvolPath

Path to the SYSVOL folder.

Type: String[]
Parameter Sets: OfflineDit
Aliases:

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

-ResolveIndexes

Reindexes the DIT file in case of invalid index data.

Type: Boolean
Parameter Sets: OfflineDit
Aliases:

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

-OfflineDit

Specifies that the application registers the DIT file as a backup.

Type: SwitchParameter
Parameter Sets: OfflineDit
Aliases:

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

-InformationAction

@{Text=}

Type: ActionPreference
Parameter Sets: (All)
Aliases: infa

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

-InformationVariable

@{Text=}

Type: String
Parameter Sets: (All)
Aliases: iv

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS

 

Get-RMADBackupObject


external help file: QuestSoftware.RecoveryManager.AD.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:

schema: 2.0.0

SYNOPSIS

Get objects from backups

SYNTAX

InputObject+Name (Default)

Get-RMADBackupObject -InputObject <BackupInfo[]> [-Name <String[]>] [-BackupPassword <SecureString>]
 [-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
 [-AdLdsInstance <String[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>]
 [<CommonParameters>]

InputObject+Id

Get-RMADBackupObject -InputObject <BackupInfo[]> [-Id <String[]>] [-BackupPassword <SecureString>]
 [-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
 [-AdLdsInstance <String[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>]
 [<CommonParameters>]

InputObject+Filter

Get-RMADBackupObject -InputObject <BackupInfo[]> [-Filter <String>] [-BackupPassword <SecureString>]
 [-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
 [-AdLdsInstance <String[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>]
 [<CommonParameters>]

BackupGuid+Id

Get-RMADBackupObject -BackupGuid <Guid[]> [-Id <String[]>] [-BackupPassword <SecureString>]
 [-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
 [-AdLdsInstance <String[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>]
 [<CommonParameters>]

BackupGuid+Name

Get-RMADBackupObject -BackupGuid <Guid[]> [-Name <String[]>] [-BackupPassword <SecureString>]
 [-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
 [-AdLdsInstance <String[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>]
 [<CommonParameters>]

BackupGuid+Filter

Get-RMADBackupObject -BackupGuid <Guid[]> [-Filter <String>] [-BackupPassword <SecureString>]
 [-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
 [-AdLdsInstance <String[]>] [-InformationAction <ActionPreference>] [-InformationVariable <String>]
 [<CommonParameters>]

DESCRIPTION

Retrieves specific objects from certain backups registered with Recovery Manager for Active Directory.

EXAMPLES

Example 1

PS C:\> Get-RMADBackup | Get-RMADBackupObject -Name "Adm" -Attribute *

Retrieves a list of all backups that are registered in Recovery Manager for Active Directory and then search for the object using ambiguous name resolution.
In this example, you will get a list of all objects that have 'Adm' in the beginning of any naming attribute from the 'ANR attribute Set'.

Example 2

PS C:\> Get-RMADBackup | Get-RMADBackupObject -SearchBase 'CN=Partitions,CN=Configuration,DC=CONTOSO,DC=COM' -Filter "objectClass='crossRef'"

Retrieves a list of objects from the container that is specified in the 'SearchBase' parameter.
The objects are filtered by the 'objectClass' attribute.

Example 3

PS C:\> Get-RMADBackup | Get-RMADBackupObject -Filter "givenName=Name 1|Name 2,cn=Smith"

Retrieves a list of all registered backups and all objects that have 'Name 1' or 'Name 2' value for the 'givenName' attribute and 'Smith' for the 'CN' attribute.

Example 4

PS C:\> Get-RMADObject -Filter  "distinguishedName='CN=name1,DC=mydomain,DC=com'"

Retrieves a list of all registered backups and all objects that have the following distinguished name: CN=name1,DC=mydomain,DC=com.

Example 5

PS C:\> Get-RMADBackup | Get-RMADBackupObject -AdLdsInstance 'ContosoApplication' -Filter "distinguishedName='CN=Users,CN=Roles,CN=App1,DC=contoso,DC=com'"

Retrieves the object with the specified distinguished name from the backup of the 'ContosoApplication' AD LDS instance.

PARAMETERS

-InputObject

Specifies backups that contain the retrieved object.
To get the backup, use the Get-RMADBackup cmdlet.

Type: BackupInfo[]
Parameter Sets: InputObject+Name, InputObject+Id, InputObject+Filter
Aliases: Backup, Backups

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByValue)
Accept wildcard characters: False

-Name

Retrieves objects whose Name attribute value is equal to the value specified in this parameter.

Type: String[]
Parameter Sets: InputObject+Name, BackupGuid+Name
Aliases:

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

-BackupPassword

Specifies the password to access a password-protected backup.
This is the same password that is set in the computer collection properties in the Recovery Manager console.

Type: SecureString
Parameter Sets: (All)
Aliases:

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

-Attribute

Specifies the object attributes to retrieve in addition to the attributes the cmdlet retrieves by default.
If this parameter is omitted or empty, the cmdlet retrieves the following default set of object attributes:
- distinguishedName
- name
- objectClass
- objectguid

Type: String[]
Parameter Sets: (All)
Aliases:

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

-SearchBase

Specifies an Active Directory container in which to search for objects.
The search is performed in the specified container and all its subcontainers.
Specify the distinguished name (DN) of the container in which you want to search.

Type: String
Parameter Sets: (All)
Aliases:

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

-Count

Limits the maximum number of objects to retrieve.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-KeepBackupUnpacked

Determines whether to save the unpacked backup after the search operation.
If this parameter is not set, the unpacked backup will be deleted after the search operation is completed.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-AdLdsInstance

If you search in the AD LDS instance backup, you should specify a list of AD LDS instances in which you want to search.

Type: String[]
Parameter Sets: (All)
Aliases: AdamInstance

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

-Filter

Allows you to filter objects by attribute names and attribute values.
For details, see the examples provided for this cmdlet.

Type: String
Parameter Sets: InputObject+Filter, BackupGuid+Filter
Aliases:

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

-Id

Specifies the identifier of the object to retrieve.
This parameter accepts one of the following:
- GUID
- Distinguished name (DN)
- samAccountName
- userLogonName

Type: String[]
Parameter Sets: InputObject+Id, BackupGuid+Id
Aliases:

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

-BackupGuid

GUID of the registered backup.

Type: Guid[]
Parameter Sets: BackupGuid+Id, BackupGuid+Name, BackupGuid+Filter
Aliases: Guid

Required: True
Position: Named
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False

-InformationAction

@{Text=}

Type: ActionPreference
Parameter Sets: (All)
Aliases: infa

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

-InformationVariable

@{Text=}

Type: String
Parameter Sets: (All)
Aliases: iv

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

OUTPUTS

NOTES

RELATED LINKS

 

Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen