external help file: QuestSoftware.RecoveryManager.AD.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:
Retrieves objects that represent Recovery Manager Backup Agents, or discovers manually preinstalled Recovery Manager Backup Agents.
Get-RMADBackupAgent [-Discover] [-UpdateInfo] [<CommonParameters>]
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.
PS C:\> Get-RMADBackupAgent
This code returns a list of installed and registered in the Recovery Management Console Backup Agents.
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.
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: False
Accept pipeline input: False
Accept wildcard characters: False
Specifies whether Backup Agents information should be re-requested.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
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.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:
Gets the content of the backups held at a specified location.
Get-RMADBackupInfo [-Path] <String[]> [-BackupPassword <SecureString>] [-UseLegacyEncryption] [-IgnoreReadOnly]
[<CommonParameters>]
Get-RMADBackupInfo [-Path] <String[]> [-SysvolPath <String[]>] [-ResolveIndexes <Boolean>] [-OfflineDit]
[-IgnoreReadOnly] [<CommonParameters>]
Get-RMADBackupInfo [-BackupPassword <SecureString>] [-UseLegacyEncryption] [-IgnoreReadOnly]
[<CommonParameters>]
The Get-RMADBackupInfo cmdlet gets the content of the backups created with Recovery Manager and held at the location specified by the path.
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.
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.
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
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
Specifies that the application registers the DIT file as a backup.
Type: SwitchParameter
Parameter Sets: OfflineDit
Aliases:
Required: True
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
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
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
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
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: 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.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:
Get objects from backups
Get-RMADBackupObject -InputObject <BackupInfo[]> [-Name <String[]>] [-BackupPassword <SecureString>]
[-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
[-AdLdsInstance <String[]>] [<CommonParameters>]
Get-RMADBackupObject -InputObject <BackupInfo[]> [-Id <String[]>] [-BackupPassword <SecureString>]
[-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
[-AdLdsInstance <String[]>] [<CommonParameters>]
Get-RMADBackupObject -InputObject <BackupInfo[]> [-Filter <String>] [-BackupPassword <SecureString>]
[-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
[-AdLdsInstance <String[]>] [<CommonParameters>]
Get-RMADBackupObject -BackupGuid <Guid[]> [-Id <String[]>] [-BackupPassword <SecureString>]
[-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
[-AdLdsInstance <String[]>] [<CommonParameters>]
Get-RMADBackupObject -BackupGuid <Guid[]> [-Name <String[]>] [-BackupPassword <SecureString>]
[-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
[-AdLdsInstance <String[]>] [<CommonParameters>]
Get-RMADBackupObject -BackupGuid <Guid[]> [-Filter <String>] [-BackupPassword <SecureString>]
[-Attribute <String[]>] [-SearchBase <String>] [-Count <Int32>] [-KeepBackupUnpacked]
[-AdLdsInstance <String[]>] [<CommonParameters>]
Retrieves specific objects from certain backups registered with Recovery Manager for Active Directory.
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'.
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.
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.
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.
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.
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
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
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
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
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
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
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
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
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
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
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
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.PowerShell.dll-Help.xml
Module Name: Quest.RecoveryManager.AD.PowerShell
online version:
Gets security check information for a specified backup.
Get-RMADBackupSecurityStatus [-BackupGuid <Guid[]>] [-From <DateTime>] [<CommonParameters>]
Retrieves security check information for a specified backup registered with Recovery Manager for Active Directory.
PS C:\> $bkf = (Get-RMADBackup -ComputerName dc.DomainName.local)[-1]
$status = New-Object -TypeName QuestSoftware.RecoveryManager.AD.PowerShell.BackupSecurityStatus
$status.Summary = "Passed"
$status.Details = "all successful"
$status.CheckDate = Get-Date
Publish-RMADBackupSecurityStatus -BackupGuid $bkf.backupGuid -SecurityStatus $status
Get-RMADBackup -ComputerName dc.DomainName.local | %{
Get-RMADBackupSecurityStatus -BackupGuid $_.BackupGuid
}
For troubleshooting only.
This command retrieves information related to antimalware scan results for all backups registered with Recovery Manager for Active Directory.
This is the GUID of the backup for which a user wants to get the antimalware scan results.
Type: Guid[]
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
Specifies the time point to get statuses.
Type: DateTime
Parameter Sets: (All)
Aliases:
Required: False
Position: Named
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. Conditions d’utilisation Confidentialité Cookie Preference Center