Chat now with support
Chat with Support

Recovery Manager for AD Forest Edition 10.3 - Management Shell Guide

Overview
About Management Shell Installing and opening Management Shell Getting Help Descriptions of PowerShell Commands
Add-RMADBackup Add-RMADCollectionItem Add-RMADFECloudStorage Add-RMADReplicationConsole Add-RMADStorageServer Backup-RMADCollection Backup-RMADFEConsoleConfiguration Close-RMADFEProject Compare-RMADObject Convert-RMADBackup ConvertTo-RMADRecycledObject Copy-RMADFEBackup Create-RMADStorageAgentSetup Expand-RMADBackup Export-RMADBackup Export-RMADFECloudStorageBackup Export-RMADFECloudStorageServers Export-RMADFERecoveryCertificate Export-RMADFEResult Export-RMADSecureStorageBackup Export-RMADStorageServers Get-RMADBackup Get-RMADBackupAgent Get-RMADBackupInfo Get-RMADBackupObject Get-RMADBackupSecurityStatus Get-RMADCollection Get-RMADCollectionItem Get-RMADDeletedObject Get-RMADFEAvailableSubnet Get-RMADFECloudStorage Get-RMADFECloudStorageCollection Get-RMADFECloudStorageUploadSession Get-RMADFEComputer Get-RMADFEConsole Get-RMADFEConsoleConfigurationBackupSchedule Get-RMADFEConsoleConfigurationProjectFiles Get-RMADFEDnsCache Get-RMADFEDomain Get-RMADFEEvent Get-RMADFEGlobalOptions Get-RMADFEOperation Get-RMADFEPersistenceConnection Get-RMADFEProject Get-RMADFERecoveryAgent Get-RMADFESchedule Get-RMADGlobalOptions Get-RMADHybridRecoveryDomainOptions Get-RMADHybridRecoveryOptions 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 Import-RMADBackup Import-RMADFERecoveryCertificate Install-RMADBackupAgent Install-RMADFERecoveryAgent New-RMADCollection New-RMADFEProject New-RMADFERecoveryMedia New-RMADSchedule Open-RMADFEProject Protect-RMADSecureStorageServer Publish-RMADBackupSecurityStatus Refresh-RMADStorageServer Register-RMADSecureStorageBackups Remove-RMADBackup Remove-RMADBackupAgent Remove-RMADCollection Remove-RMADCollectionItem Remove-RMADFECloudStorage Remove-RMADFECloudStorageUploadSession Remove-RMADFERecoveryAgent Remove-RMADFESchedule Remove-RMADReplicationConsole Remove-RMADReplicationSchedule Remove-RMADReplicationSession Remove-RMADStorageServer Remove-RMADUnpackedComponent Rename-RMADCollection Restart-RMADFECloudStorageUploadSession Restore-RMADDeletedObject Restore-RMADDomainController Restore-RMADFEConsoleConfiguration Restore-RMADObject Resume-RMADFEOperation Resume-RMADFERecovery Save-RMADFEProject Set-RMADCollection Set-RMADFECloudStorage Set-RMADFECloudStorageCollection Set-RMADFEComputer Set-RMADFEConsoleConfigurationBackupSchedule Set-RMADFEConsoleConfigurationProjectFiles Set-RMADFEDnsCache Set-RMADFEDomain Set-RMADFEGlobalOptions Set-RMADFEPersistenceConnection Set-RMADFERecoveryMode Set-RMADFESchedule Set-RMADGlobalOptions Set-RMADHybridRecoveryDomainOptions Set-RMADHybridRecoveryOptions Set-RMADReplicationConsole Set-RMADReplicationSchedule Start-RMADFERecovery Start-RMADFERecoveryAgentOperation Start-RMADFEVerification Start-RMADHybridRecoveryDiscovery Start-RMADReplication Start-RMADReportViewer Stop-RMADFECloudStorageUploadSession Stop-RMADFEWorkflow Test-RMADBackup Test-RMADSecureStorageBackup Update-RMADBackupAgent Update-RMADFEProject Update-RMADLicense

Set-RMADHybridRecoveryOptions


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

schema: 2.0.0

SYNOPSIS

Sets the domain systems associated with the Hybrid Connector.

SYNTAX

Relay (Default)

Set-RMADHybridRecoveryOptions [-Enabled <Boolean>] [-RelayUrl <String>] [-RelayKeyName <String>]
 [-RelayKey <SecureString>] [-UsePackedBackups <Boolean>] [-SkipReplication <Boolean>] [-IgnoreReadOnly]
 [-WhatIf] [-Confirm] [<CommonParameters>]

AADConnect

Set-RMADHybridRecoveryOptions [-Enabled <Boolean>] -AADConnectHost <String>
 -AADConnectCredentials <PSCredential> [-UsePackedBackups <Boolean>] [-SkipReplication <Boolean>]
 [-IgnoreReadOnly] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Sets the domain and associated systems used in the Hybrid Connector.

EXAMPLES

Example 1

PS C:\>$key = ConvertTo-SecureString 'YDrMzfQWP8EliwRj41BtvNIZ4pH7i4pRW24klu8ZRcU=' -AsPlainText -Force
PS C:\>Set-RMADHybridRecoveryOptions -Enabled $true -RelayUrl 'https://relayurl' -RelayKeyName 'listenKey' -RelayKey $key -UsePackedBackups $true -SkipReplication $true

Returns: Nothing on success; otherwise an error

PARAMETERS

-AADConnectCredentials

Credentials to connect to the Azure Active Directory Connector.

Type: PSCredential
Parameter Sets: AADConnect
Aliases:

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

-AADConnectHost

The host where the Azure Active Directory Connector is installed.

Type: String
Parameter Sets: AADConnect
Aliases:

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

-Enabled

Setting to confirm if the Hybrid Connector is enabled. Values can be $true or $false.

Type: Boolean
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

-RelayKey

Relay key contained in the file received from ODR. This file is down loaded from ODR when the Hybrid Connection is configured in ODR.

Type: SecureString
Parameter Sets: Relay
Aliases:

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

-RelayKeyName

Relay name contained in the file received from ODR. This file is down loaded from ODR when the Hybrid Connection is configured in ODR.

Type: String
Parameter Sets: Relay
Aliases:

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

-RelayUrl

The URL contained in the file received from ODR. This file is down loaded from ODR when the Hybrid Connection is configured in ODR.

Type: String
Parameter Sets: Relay
Aliases:

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

-SkipReplication

Configures the Hybrid Connector to perform a replication via the Azure Active Directory Connector. The values can be either $true or $false.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-UsePackedBackups

Configures the Hybrid Connector use any unpacked backups that are available. The values can be either $true or $false.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Confirm

Prompts you for confirmation before running the cmdlet.

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

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

-WhatIf

Shows what would happen if the cmdlet runs.
The cmdlet is not run.

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

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

None

OUTPUTS

System.Object

NOTES

RELATED LINKS

 

Set-RMADReplicationConsole


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

schema: 2.0.0

SYNOPSIS

Sets replication properties of consoles in the replication console list.

SYNTAX

Id

Set-RMADReplicationConsole [-AccessCredential <PSCredential>] [-Enabled <Boolean>]
 [-FallbackCredential <PSCredential>] [-FileSyncEnabled <Boolean>] [-SourceFiles <String>]
 [-TargetFolder <String>] [-Id] <Int32[]> [<CommonParameters>]

ComputerName

Set-RMADReplicationConsole [-AccessCredential <PSCredential>] [-Enabled <Boolean>]
 [-FallbackCredential <PSCredential>] [-FileSyncEnabled <Boolean>] [-SourceFiles <String>]
 [-TargetFolder <String>] [-ComputerName] <String[]> [<CommonParameters>]

InputObject

Set-RMADReplicationConsole [-AccessCredential <PSCredential>] [-Enabled <Boolean>]
 [-FallbackCredential <PSCredential>] [-FileSyncEnabled <Boolean>] [-SourceFiles <String>]
 [-TargetFolder <String>] [-InputObject] <ReplicationConsole[]> [<CommonParameters>]

DESCRIPTION

Updates user credentials for connecting to a specified computer, and enables/disables the manual and scheduled replication for the console.

EXAMPLES

Example 1

PS C:\> C:\>$credential = Get-Credential
C:\>Set-RMADReplicationConsole -ComputerName Hostname1 -AccessCredential $credential -Enabled $true

This command changes the credentials for accessing the console on Hostname1, and enables the replication for the console.

Example 2

PS C:\> C:\>Set-RMADReplicationConsole -Id 1 -AccessCredential $credential -Enabled $true

This command changes the credentials for accessing the console with specified ID, and enables the replication for the console.

Example 3

PS C:\> C:\>Set-RMADReplicationConsole -ComputerName Hostname1 -FallbackCredential $([System.Management.Automation.PSCredential]::Empty)

This command removes the fallback account for the console on Hostname1.

Example 4

PS C:\> C:\>Set-RMADReplicationConsole -Id 1 -FileSyncEnabled $true -SourceFiles "C:\MyProjectFiles\*.frproj" -TargetFolder "C:\MyProjectFiles"

This command enables replication of the forest recovery project files for the console with specified ID.

PARAMETERS

-AccessCredential

Specifies the user credentials to read data from the target computer. The user must be a local Administrator on the target computer. To obtain the user credentials, create a PSCredential object using the Get-Credential cmdlet provided by Windows PowerShell. If you need to use the credentials of the currently logged in user, specify [System.Management.Automation.PSCredential]::Empty value for this parameter.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-ComputerName

Specifies the hostname of the replication console.

Type: String[]
Parameter Sets: ComputerName
Aliases:

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

-Enabled

Set replication item enabled.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-FallbackCredential

Supplies a fallback account for replacing the account that is used by the backup schedule task. The account must have administrator privileges on the system(s) to be backed up. If you need to reset the fallback account, specify [System.Management.Automation.PSCredential]::Empty value for this parameter. You can use this parameter only when Full mode is set for the console.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-FileSyncEnabled

Enables replication of forest recovery project files.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Id

Specifies the ID of the replication console.

Type: Int32[]
Parameter Sets: Id
Aliases:

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

-InputObject

Specifies the replication console object you want to update.

Type: ReplicationConsole[]
Parameter Sets: InputObject
Aliases:

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

-SourceFiles

Specifies which forest recovery project files to replicate from the source console.

Type: String
Parameter Sets: (All)
Aliases:

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

-TargetFolder

Specifies the folder to store the forest recovery project files replicated from the source console.

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

 

Set-RMADReplicationSchedule


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

schema: 2.0.0

SYNOPSIS

Sets replication schedules for a computer.

SYNTAX

Set-RMADReplicationSchedule [-Schedules <Schedule[]>] -Credential <PSCredential> [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Sets replication schedules with credentials for the Recovery Manager computer you specify.

EXAMPLES

Example 1

PS C:\> $credential = Get-Credential
$schedule=(New-RMADSchedule -Daily -StartDate "9/20/2022 10:00" -DaysInterval 1), (New-RMADSchedule -Daily -StartDate "9/20/2022 22:00" -DaysInterval 1)
C:\PS>Set-RMADReplicationSchedule -Schedule $schedule

This example illustrates how to replicate computers by using two replication schedules. The first line of this example creates a PSCredential object. The second line of this example creates two replication schedules and stores them in the $schedule variable. One schedule invokes the replicate operation once in every two days at 10 a.m. Another schedule invokes the replicate operation once in every two days at 10 p.m. The two replication schedules become effective starting from the 20th September 2022. The third line of this example set schedules with credentials to the computer you specify.

Example 2

PS C:\> $credential = Get-Credential
C:\PS>Set-RMADReplicationSchedule -Credential $credential

This command updates the credentials for an existing schedule.

PARAMETERS

-Credential

Specifies the user credentials for setting the replication schedule. The user must be a local Administrator on the target computer. To obtain the user credentials, create a PSCredential object using the Get-Credential cmdlet provided by Windows PowerShell.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Schedules

Causes the computer you specify to use the replication schedule you set by using the New-RMADSchedule cmdlet.

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

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

-Confirm

Prompts for confirmation before executing the command.

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

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

-WhatIf

Describes what would happen if you ran the command without actually running the command.

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

Required: False
Position: Named
Default value: False
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

 

Start-RMADFERecovery


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

schema: 2.0.0

SYNOPSIS

Performs the restore operation for the RMADFE project.

SYNTAX

Start-RMADFERecovery [-Force] [-NotifyByEmail <Boolean>] [-GroupPasswords <Hashtable>] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

This cmdlet starts the restore operation on the current RMADFE project.

EXAMPLES

EXAMPLE 1

PS C:\> Start-RMADFERecovery

This command performs the restore operation on the current RMADFE project.

EXAMPLE 2

$pwd1 = ConvertTo-SecureString "new password 1" -AsPlainText -Force
$pwd2 = ConvertTo-SecureString "new password 2" -AsPlainText -Force
$pwd3 = ConvertTo-SecureString "new password 3" -AsPlainText -Force
$passwords = @{ "Enterprise Admins"=$pwd1; "Domain Admins"=$pwd2; "Administrators"=$pwd3 }
Start-RMADFERecovery -GroupPasswords $passwords

This command performs the restore operation and resets the password for domain users in the following privileged groups: Enterprise Admins, Domain Admins, and Administrators.

PARAMETERS

-Force

Overrides restrictions that prevent the command from succeeding, apart from security settings.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-GroupPasswords

Resets a password for domain users in specified privileged groups. The new password can be only used once, users must change their password after logging in with the new password. Use the Set-RMADFEDomain cmdlet to enable the password resetting before you reset the password with this parameter. The password resetting option is available only for Forest Recovery and Domain Recovery modes.

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-NotifyByEmail

Allows notification about the recovery result by email.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Confirm

Prompts for confirmation before running the command.

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

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

-WhatIf

Describes what would happen if you ran the command without actually running the command.

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

Required: False
Position: Named
Default value: False
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

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating