Chat now with support
Chat with Support

Recovery Manager for AD Forest Edition 10.3.1 - 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 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-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-RMADSession Remove-RMADStorageServer Remove-RMADUnpackedComponent Rename-RMADCollection Restart-RMADFECloudStorageUploadSession Restore-RMADDeletedObject Restore-RMADDomainController Restore-RMADFEConsoleConfiguration Restore-RMADObject Resume-RMADFEOperation Resume-RMADFERecovery Save-RMADFEProject Send-RMADFEBackupToSecureStorage Set-RMADCollection Set-RMADFECloudStorage Set-RMADFECloudStorageCollection Set-RMADFEComputer Set-RMADFEConsoleConfigurationBackupSchedule 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

Get-RMADObject


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

schema: 2.0.0

SYNOPSIS

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

SYNTAX

Name (Default)

Get-RMADObject [-KeepBackupUnpacked] [-State <ObjectState>] [-Backup <Guid[]>] [-BackupPassword <SecureString>]
 [-DisableADSearch] [-Name <String[]>] [-Count <Int32>] [-Attribute <String[]>] [-SearchBase <String>]
 [-Timeout <Int32>] [-UseSsl] [-Server <String>] [-Credential <PSCredential>] [-Partition <String>]
 [-Port <Int32>] [-IgnoreReadOnly] [<CommonParameters>]

Identity

Get-RMADObject [-KeepBackupUnpacked] [-State <ObjectState>] [-Backup <Guid[]>] [-BackupPassword <SecureString>]
 [-DisableADSearch] [-Id <String[]>] [-Attribute <String[]>] [-UseSsl] [-Server <String>]
 [-Credential <PSCredential>] [-Partition <String>] [-Port <Int32>] [-IgnoreReadOnly] [<CommonParameters>]

Filter

Get-RMADObject [-KeepBackupUnpacked] [-State <ObjectState>] [-Backup <Guid[]>] [-BackupPassword <SecureString>]
 [-DisableADSearch] [-Filter <String>] [-Count <Int32>] [-Attribute <String[]>] [-SearchBase <String>]
 [-Timeout <Int32>] [-UseSsl] [-Server <String>] [-Credential <PSCredential>] [-Partition <String>]
 [-Port <Int32>] [-IgnoreReadOnly] [<CommonParameters>]

DESCRIPTION

Allows you to retrieve specific objects from Active Directory or certain backups registered with Recovery Manager for Active Directory.By default, with each object, this cmdlet retrieves the following attributes:

  • distinguishedName
  • name
  • objectClass
  • objectguid
  • isDeleted
  • isRecycled

If the object is deleted, in addition to the above-listed attributes, the cmdlet also retrieves the following attributes:

  • whenchanged
  • whencreated
  • lastKnownParent
  • msDS
  • LastKnownRDN

You can also specify additional attributes to retrieve.

EXAMPLES

Example 1

PS C:\> Get-RMADObject -Name "User 1"

This command uses ambiguous name resolution (ANR) to look for and retrieve the objects whose Name attribute value is User 1.

Example 2

PS C:\> $b = Get-RMADBackup

C:\PS>Get-RMADObject -DisableADSearch -Backup $b -Name "User 1" 
-Attribute *

In the first line of this command, the Get-RMADBackup gets all backups registered with Recovery Manager for Active Directory and stores the backup objects in the $b variable.

Example 3

PS C:\> Get-RMADObject -Name "User 1" -State Live, Deleted -Attribute usnChanged, usnCreated

This command uses ambiguous name resolution (ANR) to look for and retrieve objects whose Name attribute value is User 1 and whose state is either live or deleted. In addition to the default attribute set, the command retrieves the usnChanged and usnCreated attributes for each object.

Example 4

PS C:\> Get-RMADObject -Filter "givenName=User 1|User 2,sn=Smith"

This command retrieves the objects whose givenName attribute value is either User 1 or User 2 and whose sn attribute value is Smith.

Example 5

PS C:\> Get-RMADObject -Filter "whenCreated>=20220601123000.0Z"

This command retrieves all objects that were created on 1 June 2022 at 12:30:00 or after this date.

Example 6

PS C:\> Get-RMADObject -Filter "whenCreated=20220601000000.0Z"

This command retrieves all objects that were created on 1 June 2022 between 00:00:00 and 23:59:59.

Example 7

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

Retrieves the object whose distinguished name (DN) is CN=user1,DC=mydomain,DC=com.

Example 8

PS C:\> Get-RMADObject -Name user1 -State live -SearchBase 'OU=Users,DC=domain,DC=com'

Gets the object whose Name attribute value is user1 and that is located in the container with DN OU=Users,DC=domain,DC=com or in any of its subcontainers.

PARAMETERS

-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
  • isDeleted
  • isRecycled

To specify all available object attributes, type an asterisk (*) in this parameter.

Type: String[]
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 object to retrieve. To specify a backup, type the backup GUID in this parameter or use the Get-RMADBackup cmdlet.

Type: Guid[]
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 the password-protected backup that contains the object you want to retrieve.

Type: SecureString
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: Name, Filter
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

-DisableADSearch

When present, specifies to search Active Directory for objects to retrieve.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Filter

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

Type: String
Parameter Sets: 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: Identity
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: False
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: False
Accept pipeline input: False
Accept wildcard characters: False

-Name

Retrieves objects whose Name attribute value is equal to the value specified in this parameter. The Name attribute stores object's relative distinguished name (RDN) which looks similar to the following:
User 1\0ADEL:7dbac5c7-f38d-4270-8ac2-7a0674bc246b

Type: String[]
Parameter Sets: Name
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 you want to retrieve objects. If this parameter is omitted, the default naming context is used. This parameter is required if you specify an AD LDS (ADAM) instance host in the Server 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 connect to. If this parameter is set to 0 or omitted, 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

-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: Name, Filter
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

-State

Retrieves objects whose state is equal to any of the values specified in this parameter. This parameter can take one of the following values:

  • All
  • Deleted
  • Live
  • Recycled

When specifying multiple values in this parameter, use a comma as a separator.

Type: ObjectState
Parameter Sets: (All)
Aliases:
Accepted values: Live, Deleted, Recycled, All

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

-Timeout

Specifies the maximum wait time for retrieving the objects, in seconds. The default value is 30.

Type: Int32
Parameter Sets: Name, Filter
Aliases:

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

-UseSsl

Specifies whether use Secure Sockets Layer (SSL) to encrypt the connection.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

 

Get-RMADReplicationConsole


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

schema: 2.0.0

SYNOPSIS

Gets all the RMAD consoles in the replication console list.

SYNTAX

Get-RMADReplicationConsole [<CommonParameters>]

DESCRIPTION

Gets all the RMAD consoles in the replication console list.

EXAMPLES

Example 1

PS C:\> C:\>Get-RMADReplicationConsole

This command gets all the RMAD consoles in the replication console list.

PARAMETERS

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


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

schema: 2.0.0

SYNOPSIS

Allows you to get the replication schedule from a specified computer.

SYNTAX

Get-RMADReplicationSchedule [<CommonParameters>]

DESCRIPTION

Allows you to get the replication schedule from a specified computer.

EXAMPLES

Example 1

PS C:\> Get-RMADReplicationSchedule

This example illustrates how to get the replication schedule from a specified computer.

PARAMETERS

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


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

schema: 2.0.0

SYNOPSIS

Retrieves information about replication sessions.

SYNTAX

Get-RMADReplicationSession [[-Id] <Int32[]>] [<CommonParameters>]

DESCRIPTION

Retrieves replication sessions. Each replication session contains a set of properties including the session start time, end time, and replication result.

EXAMPLES

Example 1

PS C:\> Get-RMADReplicationSession

This command retrieves all the replication sessions.

Example 2

PS C:\> Get-RMADReplicationSession -Id 1

This command retrieves the replication session by session ID.

PARAMETERS

-Id

Specifies the IDs of the replication sessions.

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

Required: False
Position: 0
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

 

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating