external help file: QuestSoftware.RecoveryManager.AD.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:
Restores Active Directory objects from a backup.
This cmdlet requires Windows PowerShell to be started using a multi-threaded apartment (MTA).
Restore-RMADObject [-Attribute <String[]>] [-NoReport] [-SkipReplication] [-KeepBackupUnpacked]
[-Id] <String[]> -Backup <Guid> [-BackupPassword <SecureString>] [-ProcessChildren]
[-ChildObjectClass <String[]>] [-ReportUnchangedAttributes] [-ReportUnchangedObjects]
[-SQLCredential <PSCredential>] [-ChangeAuditorDbName <String>] [-ChangeAuditorDbCredential <PSCredential>]
[-RestoreUsingChangeAuditor] [-Server <String>] [-Credential <PSCredential>] [-Partition <String>]
[-Port <Int32>] [-IgnoreReadOnly] [<CommonParameters>]
Restore-RMADObject [-Attribute <String[]>] [-NoReport] [-SkipReplication] [-KeepBackupUnpacked]
[-Id] <String[]> -Backup <Guid> [-BackupPassword <SecureString>] [-ProcessChildren]
[-ChildObjectClass <String[]>] [-ReportUnchangedAttributes] [-ReportUnchangedObjects]
[-SQLCredential <PSCredential>] [-ChangeAuditorDbName <String>] [-ChangeAuditorDbCredential <PSCredential>]
[-RestoreUsingChangeAuditor] [-Server <String>] [-Credential <PSCredential>] [-Partition <String>]
[-Port <Int32>] [-IgnoreReadOnly] [<CommonParameters>]
Restore-RMADObject [-Attribute <String[]>] [-NoReport] [-SkipReplication] [-KeepBackupUnpacked]
[-Id] <String[]> -Backup <Guid> [-BackupPassword <SecureString>] [-ProcessChildren]
[-ChildObjectClass <String[]>] [-ReportUnchangedAttributes] [-ReportUnchangedObjects]
[-SQLCredential <PSCredential>] [-AdLds] -AdLdsInstance <String> [-ChangeAuditorDbName <String>]
[-ChangeAuditorDbCredential <PSCredential>] [-RestoreUsingChangeAuditor] [-Server <String>]
[-Credential <PSCredential>] [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly] [<CommonParameters>]
Restore-RMADObject [-Attribute <String[]>] [-NoReport] [-SkipReplication] [-KeepBackupUnpacked]
[-Id] <String[]> -Backup <Guid> [-BackupPassword <SecureString>] [-ProcessChildren]
[-ChildObjectClass <String[]>] [-ReportUnchangedAttributes] [-ReportUnchangedObjects]
[-SQLCredential <PSCredential>] [-AdLds] [-ChangeAuditorDbName <String>]
[-ChangeAuditorDbCredential <PSCredential>] [-ConfigureFirewall] [-RestoreUsingChangeAuditor]
[-Server <String>] [-Credential <PSCredential>] [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly]
[<CommonParameters>]
Restore-RMADObject [-Attribute <String[]>] [-NoReport] [-SkipReplication] [-KeepBackupUnpacked]
[-Id] <String[]> -Backup <Guid> [-BackupPassword <SecureString>] [-UseAgentlessMethod] [-ProcessChildren]
[-ChildObjectClass <String[]>] [-ReportUnchangedAttributes] [-ReportUnchangedObjects]
[-SQLCredential <PSCredential>] [-AdLds] [-ChangeAuditorDbName <String>]
[-ChangeAuditorDbCredential <PSCredential>] [-RestoreUsingChangeAuditor] [-Server <String>]
[-Credential <PSCredential>] [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly] [<CommonParameters>]
Restores the Active Directory objects that have specified parameters from a backup. You can only use this cmdlet when Windows PowerShell is started using MTA. To start Windows PowerShell using MTA, run this command: PowerShell -mta
PS C:\> $backups = Get-RMADBackup | Sort-Object -Property date -Descending
C:\PS>$object = Get-RMADObject -Id "user1"
C:\PS>Restore-RMADObject -Id $object.ObjectInfo.Guid -Backup $backups[0] -UseAgentlessMethod -NoReport
In the first line of this example, the Get-RMADBackup cmdlet gets all registered backups and sorts them by date in the descending order. Then, the backup objects are stored in the $backups variable.
PS C:\> $b = Get-RMADBackup -Id 1
C:\PS>Restore-RMADObject -Id "user1" -Backup $b -Attribute samAccountName,description -ReportUnchangedAttributes
Start-RMADReportViewer
In the first line of this example, the Get-RMADBackup cmdlet gets the registered backup whose ID is 1. Then, the backup object is stored in the $b variable.
Specifies that the AD LDS instance is used as a data storage.
Type: SwitchParameter
Parameter Sets: ADLds
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Type: SwitchParameter
Parameter Sets: Firewall, Agentless
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
If you restore the backed up AD LDS (ADAM) objects, you should specify the AD LDS instance whose backup you want to use.
Type: String
Parameter Sets: ADLds
Aliases: AdamInstance
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the display names of the attributes to restore.
When specifying multiple display names, use a comma as a separator.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the backup that contains the AD objects to be restored.
Type: Guid
Parameter Sets: (All)
Aliases:
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
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
Specifies the credentials for connecting to the Change Auditor SQL database. If this parameter is omitted, the credentials of the current logged in user will be used.
Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the location of the Change Auditor SQL database. If this parameter is omitted, the 'ModifyBy' cell in AD reports will be empty.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Allows you to restore only those child objects that belong to the classes you specify in this parameter.
Type: String[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies whether Recovery Manager automatically configures Windows Firewall on domain controllers to allow compare and restore operations.
Type: SwitchParameter
Parameter Sets: Firewall
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
The user name and password of the user account with which you want to connect, in the form of a PSCredential object. Use the Get-Credential cmdlet provided by Windows PowerShell to pass a PSCredential object to this parameter. If this parameter is omitted, the credentials of current user account are used.
Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the objects to restore. To specify an object, you can use object GUID, distinguished name (DN), sAMAccountName, or user principal name (UPN).
Type: String[]
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
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: False
Accept pipeline input: False
Accept wildcard characters: False
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: False
Accept pipeline input: False
Accept wildcard characters: False
When present, specifies to not create any report about the restore operation.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Specifies the AD LDS (ADAM) partition where you want to restore objects.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the port on which to access the AD LDS (ADAM) instance where you want to restore objects.
Type: Int32
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
When present, specifies to process children of the objects specified in the Id attribute.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Includes the object attributes that have not changed since the time of the specified backup into the operation report.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Includes the objects that have not changed since the time of the specified backup into the operation report.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Specifies if Change Auditor is used to restore the latest changes to the object.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Specifies the domain controller or ADAM instance host on which objects are to be restored. The domain controller can be specified by its computer name, IP address, or domain name. If you specify a domain name, deleted objects are restored to any available domain controller in the specified domain. The ADAM instance host can be specified by its computer name or IP address. If this parameter is omitted, objects are restored to any available domain controller in the current domain.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
When present, specifies to skip replication during the restore operation.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Specifies the user name and password of the user account with which you want to connect to SQL Server to generate a report about the performed operation. The user name and password must be in the form of a PSCredential object. When this parameter is omitted, the cmdlet uses the credentials of the account under which Management Shell is running. Use the Get-Credential cmdlet provided by Windows PowerShell to pass a PSCredential object to this parameter.
Type: PSCredential
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies to use the agentless method to access the target domain controller. If this parameter is omitted, the target domain controller is accessed via Restore Agent.
Type: SwitchParameter
Parameter Sets: Agentless
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
external help file: QuestSoftware.RecoveryManager.AD.PowerShellFE.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShellFE
online version:
Resumes paused recovery process operation.
Resume-RMADFEOperation [[-ComputerName] <String>] [<CommonParameters>]
When recovery operation is paused it can be resumed by this cmdlet
PS C:\> Resume-RMADFEOperation -Name dc1.acme.com
This command resumes paused recovery process operation for specified computer.
PS C:\> Resume-RMADFEOperation
This command resumes paused recovery process operations for all computers from the current RMADFE project.
Specifies the fully qualified domain name of the computer.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
external help file: QuestSoftware.RecoveryManager.AD.PowerShellFE.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShellFE
online version:
Resumes recovery process.
Resume-RMADFERecovery [-ProjectPassword] <SecureString> [-IgnoreDialogueTimeout] [-GroupPasswords <Hashtable>]
[<CommonParameters>]
Resume-RMADFERecovery [-DropStoredSession] [<CommonParameters>]
If some workstations have begun the restore process and failed, this cmdlet can resume the recovery process.
SQL Persistence must be properly configured on both processes. Both processes must be registered as restoring workstations.
If you chose to reset the password for domain users in privileged groups when you started a forest recovery, you need to provide passwords again using -GroupPasswords parameter because the product does not store user passwords.
WS1:
PS C:\> Open-RMADFEProject 'c:\ActiveDirectoryRestore.frproj' (ConvertTo-SecureString "Password" -AsPlainText -Force)
Start-RmadFeRecovery -Force
WS2:
PS C:\> Resume-RmadFeRecovery -ProjectPassword (ConvertTo-SecureString "Password" -AsPlainText -Force)
For example, there are two RMAD workstations in your environment. Both workstations must be registered as restoring workstations. Therefore, if one of them is not responding, you can run the recovery process from another workstation.
PS C:\> Resume-RmadFeRecovery -DropStoredSession
This command cleans up the recovery session if any.
Lead to a session drop in the persistence DB.
Type: SwitchParameter
Parameter Sets: Drop
Aliases:
Required: True
Position: 2
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
Resets the password for domain users in the specified privileged groups.
Type: Hashtable
Parameter Sets: Resume
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Allows you to proceed if another console does not answer.
Type: SwitchParameter
Parameter Sets: Resume
Aliases:
Required: False
Position: 1
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
The password that was configured for restore project.
Type: SecureString
Parameter Sets: Resume
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
external help file: QuestSoftware.RecoveryManager.AD.PowerShellFE.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShellFE
online version:
Saves the RMADFE project.
Save-RMADFEProject [-Path] <String> [-Password] <SecureString> [<CommonParameters>]
This cmdlet saves the RMADFE project to the specified location. You must also supply the password that is used to access the project content.
PS C:\> Save-RMADFEProject -Path C:\RMADFeProjects\SampleProject.frproj -Password (ConvertTo-SecureString "project password" -AsPlainText -Force)
This command saves SampleProject.frproj to the specified location.
Specifies the password that is used to access the RMADFE project content.
Type: SecureString
Parameter Sets: (All)
Aliases:
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the full path to the RMADFE project file.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center