Chat now with support
Chat with Support

Recovery Manager for AD Disaster Recovery Edition 10.1.1 - 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 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-RMADFEComputer Add-RMADReplicationConsole Add-RMADStorageServer Backup-RMADCollection Close-RMADFEProject Compare-RMADObject Convert-RMADBackup ConvertTo-RMADRecycledObject Create-RMADStorageManagementAgentSetup Expand-RMADBackup Export-RMADBackup Export-RMADFERecoveryCertificate Export-RMADFEResult Get-RMADBackup Get-RMADBackupAgent Get-RMADBackupInfo Get-RMADBackupObject Get-RMADBackupSecurityStatus Get-RMADCollection Get-RMADCollectionItem Get-RMADDeletedObject 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-RMADStorageServers Import-RMADBackup Import-RMADFERecoveryCertificate Install-RMADBackupAgent Install-RMADFERecoveryAgent New-RMADCollection New-RMADFEProject New-RMADFERecoveryMedia New-RMADSchedule Open-RMADFEProject Publish-RMADBackupSecurityStatus Remove-RMADBackup Remove-RMADBackupAgent Remove-RMADCollection Remove-RMADCollectionItem Remove-RMADFEComputer 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 Start-RMADFERecovery Start-RMADFEVerification Start-RMADReplication Start-RMADReportViewer Stop-RMADFEWorkflow Update-RMADBackupAgent Update-RMADFEProject Update-RMADLicense

Compare-RMADObject


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

schema: 2.0.0

SYNOPSIS

Compares Active Directory objects.
This cmdlet requires Windows PowerShell to be started using a multi-threaded apartment (MTA).

SYNTAX

Default (Default)

Compare-RMADObject [-ProcessRecycledObjects] [-Attribute <String[]>] [-Server <String>]
 [-Credential <PSCredential>] [-Backup <Guid>] [-Backup1 <Guid>] [-Backup2 <Guid>]
 [-Backup1Password <SecureString>] [-Backup2Password <SecureString>] [-KeepBackupUnpacked] [-Id] <String[]>
 [-ProcessChildren] [-ChildObjectClass <String[]>] [-ReportUnchangedAttributes] [-ReportUnchangedObjects]
 [-SQLCredential <PSCredential>] [-ChangeAuditorDbName <String>] [-RestoreUsingChangeAuditor]
 [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly] [-InformationAction <ActionPreference>]
 [-InformationVariable <String>] [<CommonParameters>]

ADAndBackup

Compare-RMADObject [-ProcessRecycledObjects] [-Attribute <String[]>] [-Server <String>]
 [-Credential <PSCredential>] -Backup <Guid> [-BackupPassword <SecureString>] [-KeepBackupUnpacked]
 [-Id] <String[]> [-ProcessChildren] [-ChildObjectClass <String[]>] [-ReportUnchangedAttributes]
 [-ReportUnchangedObjects] [-SQLCredential <PSCredential>] [-ChangeAuditorDbName <String>]
 [-RestoreUsingChangeAuditor] [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly]
 [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

ADLds

Compare-RMADObject [-ProcessRecycledObjects] [-Attribute <String[]>] [-Server <String>]
 [-Credential <PSCredential>] [-Backup <Guid>] [-BackupPassword <SecureString>] [-KeepBackupUnpacked]
 [-Id] <String[]> [-ProcessChildren] [-ChildObjectClass <String[]>] [-ReportUnchangedAttributes]
 [-ReportUnchangedObjects] [-SQLCredential <PSCredential>] [-AdLds] -AdLdsInstance <String>
 [-ChangeAuditorDbName <String>] [-RestoreUsingChangeAuditor] [-Partition <String>] [-Port <Int32>]
 [-IgnoreReadOnly] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

Firewall

Compare-RMADObject [-ProcessRecycledObjects] [-Attribute <String[]>] [-Server <String>]
 [-Credential <PSCredential>] [-Backup <Guid>] [-BackupPassword <SecureString>] [-KeepBackupUnpacked]
 [-Id] <String[]> [-ProcessChildren] [-ChildObjectClass <String[]>] [-ReportUnchangedAttributes]
 [-ReportUnchangedObjects] [-SQLCredential <PSCredential>] [-AdLds] [-ChangeAuditorDbName <String>]
 [-ConfigureFirewall] [-RestoreUsingChangeAuditor] [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly]
 [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

Agentless

Compare-RMADObject [-ProcessRecycledObjects] [-Attribute <String[]>] [-Server <String>]
 [-Credential <PSCredential>] [-Backup <Guid>] [-BackupPassword <SecureString>] [-KeepBackupUnpacked]
 [-Id] <String[]> [-UseAgentlessMethod] [-ProcessChildren] [-ChildObjectClass <String[]>]
 [-ReportUnchangedAttributes] [-ReportUnchangedObjects] [-SQLCredential <PSCredential>] [-AdLds]
 [-ChangeAuditorDbName <String>] [-RestoreUsingChangeAuditor] [-Partition <String>] [-Port <Int32>]
 [-IgnoreReadOnly] [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

TwoBackups

Compare-RMADObject [-ProcessRecycledObjects] [-Attribute <String[]>] [-Server <String>]
 [-Credential <PSCredential>] -Backup1 <Guid> -Backup2 <Guid> [-Backup1Password <SecureString>]
 [-Backup2Password <SecureString>] [-KeepBackupUnpacked] [-Id] <String[]> [-ProcessChildren]
 [-ChildObjectClass <String[]>] [-ReportUnchangedAttributes] [-ReportUnchangedObjects]
 [-SQLCredential <PSCredential>] [-ChangeAuditorDbName <String>] [-RestoreUsingChangeAuditor]
 [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly] [-InformationAction <ActionPreference>]
 [-InformationVariable <String>] [<CommonParameters>]

DESCRIPTION

Allows you to compare the following:* Live Active Directory objects against their versions in a backup.

  • Active Directory objects held in two backups.To fill in the 'ModifyBy' field for a report, use the ChangeAuditorDbName parameter.To view a report about the compare operation performed by this cmdlet, use the Start-RMADReportViewer cmdlet.
    You can only use this cmdlet when Windows PowerShell is started using MTA.
    To start Windows PowerShell using MTA, run this command:
    PowerShell -mta

EXAMPLES

Example

PS C:\> $b = (Get-RMADBackup -Domain dom1.local | Sort-Object -Property Date)[-1]
C:\PS>Compare-RMADObject -Backup $b.Path -Id "ou=ou1,dc=dom1,dc=local" -ProcessChildren -ChangeAuditorDbName ".\ChangeAuditor"

In this example, the Get-RMADBackup cmdlet gets all backups existing for the dom1.local domain.

PARAMETERS

-ProcessRecycledObjects

When present, specifies to process recycled objects.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Attribute

Specifies the display names of the object attributes to compare.
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

-Server

Specifies the domain controller or ADAM instance host from which objects are to be retrieved.
The domain controller can be specified by its computer name, IP address, or domain name.
If you specify a domain name, deleted objects are retrieved from 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 retrieved from 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

-Credential

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.
Use this parameter if you want to compare AD objects in a backup with their counterparts in Active Directory.
If this parameter is omitted, the credentials of current user account are used.
This parameter is ignored if you compare AD objects in a backup with their counterparts in another backup.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Backup

Specifies the backup that contains the AD objects to be compared.
Use this parameter if you want to compare AD objects in a backup with their counterparts in Active Directory.

Type: Guid
Parameter Sets: Default, ADLds, Firewall, Agentless
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: Guid
Parameter Sets: ADAndBackup
Aliases:

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

-Backup1

Specifies the first backup that contains the AD objects to be compared.
Use this parameter if you want to compare AD objects held in backups.
The backup specified in this parameter must be registered in the Recovery Manager database.

Type: Guid
Parameter Sets: Default
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: Guid
Parameter Sets: TwoBackups
Aliases:

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

-Backup2

Specifies the second backup that contains the AD objects to be compared.
Use this parameter if you want to compare AD objects held in backups.
The backup specified in this parameter must be registered in the Recovery Manager database.

Type: Guid
Parameter Sets: Default
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Type: Guid
Parameter Sets: TwoBackups
Aliases:

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

-Backup1Password

Specifies the password to access the first backup, if the backup is password-protected.
This is the same password that is set for the backup in the Recovery Manager console.

Type: SecureString
Parameter Sets: Default, TwoBackups
Aliases:

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

-Backup2Password

Specifies the password to access the second backup, if the backup is password-protected.
This is the same password that is set for the backup in the Recovery Manager console.

Type: SecureString
Parameter Sets: Default, TwoBackups
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

-Id

Specifies the objects to compare.
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

-ProcessChildren

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: None
Accept pipeline input: False
Accept wildcard characters: False

-ChildObjectClass

Specifies the child object classes to process.
When specifying multiple classes, 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

-ReportUnchangedAttributes

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: None
Accept pipeline input: False
Accept wildcard characters: False

-ReportUnchangedObjects

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: None
Accept pipeline input: False
Accept wildcard characters: False

-SQLCredential

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 compare 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

-ChangeAuditorDbName

Specifies a location of the ChangeAuditor 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

-RestoreUsingChangeAuditor

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: None
Accept pipeline input: False
Accept wildcard characters: False

-Partition

Specifies the AD LDS (ADAM) partition where you want to compare objects.

Type: String
Parameter Sets: (All)
Aliases:

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

-Port

Specifies the port on which to access the AD LDS (ADAM) instance that hosts the objects you want to compare.

Type: Int32
Parameter Sets: (All)
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

-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: ADAndBackup, ADLds, Firewall, Agentless
Aliases:

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

-AdLds

Specifies that the AD LDS instance is used as a data storage.

Type: SwitchParameter
Parameter Sets: ADLds
Aliases:

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

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

-AdLdsInstance

If you compare the object changes in AD LDS (ADAM), you should specify the AD LDS (ADAM) 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

-UseAgentlessMethod

Specifies to use the agentless method to access a domain controller.
Use this parameter if you want to compare AD objects in a backup with their counterparts in Active Directory.
If this parameter is omitted, the domain controller is accessed by using Restore Agent.
This parameter is ignored if you compare AD objects in a backup with their counterparts in another backup.

Type: SwitchParameter
Parameter Sets: Agentless
Aliases:

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

-ConfigureFirewall

Specifies whether Recovery Manager automatically configures Windows Firewall on the target Windows Server 2008-based or Windows Server 2012-based DCs to allow compare and restore operations.

Type: SwitchParameter
Parameter Sets: Firewall
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

The Backup 1 and Backup 2 parameters must specify backups for the same domain controller.In the DomainController parameter, you must specify the same domain controller whose backup you specified in the Backup parameter.

RELATED LINKS

 

Convert-RMADBackup


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

schema: 2.0.0

SYNOPSIS

Converts Windows Server backups into RMAD Bare Metal Recovery backups.

SYNTAX

Convert-RMADBackup [-WindowsServerBackupLocation] <String> [-BareMetalRecoveryPath] <String> [-AsJob]
 [-InformationAction <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

DESCRIPTION

Converts native Windows Server Backups into RMAD Bare Metal Recovery backups.

EXAMPLES

Example 1

PS C:\> Convert-RMADBackup \\backup_srv01\wsb\WindowsImageBackup \\backup_srv01\rmad\bmr.vhdx

Synchronously starts the conversion of the Windows Server backup to the bmr.vhdx file located on the network share.

Example 2

PS C:\> Convert-RMADBackup \\backup_srv01\wsb\WindowsImageBackup \\backup_srv01\rmad\bmr.vhdx | Add-RMADBackup

Synchronously starts the conversion of the Windows Server backup located at the remote network share, puts the result into the bmr.vhdx file, and then registers the resulting backup.

Example 3

PS C:\> $job = Convert-RMADBackup D:\WindowsImageBackup D:\bmr.vhdx -AsJob
$job.StatusMessage

Runs conversion as a background job and shows the current status message.

PARAMETERS

-WindowsServerBackupLocation

Specifies the full path to the Windows Server backup.
You must specify the path including the WindowsImageBackup folder.

Type: String
Parameter Sets: (All)
Aliases:

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

-BareMetalRecoveryPath

Specifies the full path to the RMAD Bare Metal Recovery backup file.

Type: String
Parameter Sets: (All)
Aliases:

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

-AsJob

Runs the conversion process as a background job.

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

String

NOTES

RELATED LINKS

 

ConvertTo-RMADRecycledObject


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

schema: 2.0.0

SYNOPSIS

Recycles specific deleted Active Directory objects.

SYNTAX

ConvertTo-RMADRecycledObject -Name <String[]> [-Force] [-Server <String>] [-Credential <PSCredential>]
 [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly] [-InformationAction <ActionPreference>]
 [-InformationVariable <String>] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Allows you to manually recycle specific deleted Active Directory objects held in Microsoft's Active Directory Recycle Bin in the forest where Recovery Manager is installed.
This cmdlet overrides the deleted object lifetime setting that applies to the deleted objects being recycled.
You can only use this cmdlet if Microsoft's Active Directory Recycle Bin feature is enabled in the forest where Recovery Manager is installed.

EXAMPLES

Example 1

PS C:\> (Get-RMADDeletedObject dc1.dom1.lab.local) |
Where-Object { $_.objectclass -contains "user" } |
Foreach-Object { ConvertTo-RMADRecycledObject -Name $_.Name -Server dc1.dom1.lab.local }

This example shows how to recycle all user objects held in Microsoft's Active Directory Recycle Bin.
The Get-RMADDeletedObject cmdlet gets all deleted objects from Microsoft's Active Directory Recycle Bin by connecting to the dc1.dom1.lab.local domain controller.
Then the Get-RMADDeletedObject cmdlet pipes the objects to the Where-Object cmdlet that filters out user objects.
Then, the Foreach-Object cmdlet uses the ConvertTo-RMADRecycledObject cmdlet to transfer each user object to the recycled state.

Example 2

PS C:\> ConvertTo-RMADRecycledObject -Name "John Doe\0ADEL:7dbac5c7-f38d-4270-8ac2-7a0674bc246b"

Converts the deleted object "John Doe\0ADEL:7dbac5c7-f38d-4270-8ac2-7a0674bc246b" to recycled state.

PARAMETERS

-Name

Allows you to specify the deleted object you want to recycle.
To specify a deleted object, enter the value of the object's Name attribute in this parameter.
The Name attribute provides the object's relative distinguished name (RDN) that looks similar to the following:
John Doe\0ADEL:7dbac5c7-f38d-4270-8ac2-7a0674bc246bTo view the value of the Name attribute for a deleted object, you can use the Get-RMADDeletedObject cmdlet.

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

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

-Force

Suppresses the cmdlet prompt for confirmation.
When this parameter is omitted, the cmdlet prompts you for confirmation before recycling objects.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Server

Specifies the Active Directory domain, domain controller, or AD LDS (ADAM) instance host from which you want the cmdlet to retrieve objects.
If this parameter is omitted, the cmdlet retrieves objects from any available domain controller in the current domain.
To specify a domain controller or AD LDS (ADAM) instance host, use the computer name or IP address.
If you specify an Active Directory domain name in this parameter, the cmdlet retrieves objects from any available domain controller in the specified domain.

Type: String
Parameter Sets: (All)
Aliases:

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

-Credential

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.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Partition

Specifies the distinguished name of the Active Directory partition from which deleted objects are to be retrieved.
If this parameter is omitted, the default naming context is used.
This parameter is required if you specify an ADAM instance host in the DirectoryHost parameter.

Type: String
Parameter Sets: (All)
Aliases:

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

-Port

Specifies the port number to be used for connection.
If this parameter is set to 0 or not specified, the default LDAP port (389) is used.

Type: Int32
Parameter Sets: (All)
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

-WhatIf

Describes what would happen if you executed the command without actually executing the command.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: wi

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

-Confirm

Prompts for a confirmation before executing the command.

Type: SwitchParameter
Parameter Sets: (All)
Aliases: cf

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

 

Create-RMADStorageManagementAgentSetup


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

schema: 2.0.0

SYNOPSIS

Creates storage server management agent setup.

SYNTAX

Create-RMADStorageManagementAgentSetup [-Path] <String> [<CommonParameters>]

DESCRIPTION

Create storage server management agent setup bundle packed to the ZIP archive that contains required components to deploy the server management agent.

EXAMPLES

Example 1

PS C:\> Create-RMADStorageManagementAgentSetup -Path "C:\Setup.zip"

Creates a setup bundle and puts it to the specified file.

PARAMETERS

-Path

Path to the result file where to create setup.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 0
Default value: None
Accept pipeline input: True (ByValue)
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

String

NOTES

RELATED LINKS

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating