Recovery Manager for AD 10.3.1 - Management Shell Guide

Set-RMADCollection

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

schema: 2.0.0

SYNOPSIS

Sets properties for a computer collection.

SYNTAX

Name (Default)

Set-RMADCollection [-Name] <String[]> [-BackupComponents <BackupComponents>] [-Properties <Hashtable>]
 [-Schedule <Schedule[]>] [-ScheduleCredential <PSCredential>] [-AgentCredentialEnabled <Boolean>]
 [-AgentCredential <PSCredential>] [-StorageCredentialEnabled <Boolean>] [-StorageCredential <PSCredential>]
 [-SecondaryStorageCredential <PSCredential>] [-RetentionPolicyEnabled <Boolean>]
 [-RetentionPolicyCount <Int32>] [-PassThru] [-IgnoreReadOnly] [-WhatIf] [-Confirm] [<CommonParameters>]

InputObject

Set-RMADCollection [-InputObject] <ComputerCollection[]> [-BackupComponents <BackupComponents>]
 [-Properties <Hashtable>] [-Schedule <Schedule[]>] [-ScheduleCredential <PSCredential>]
 [-AgentCredentialEnabled <Boolean>] [-AgentCredential <PSCredential>] [-StorageCredentialEnabled <Boolean>]
 [-StorageCredential <PSCredential>] [-SecondaryStorageCredential <PSCredential>]
 [-RetentionPolicyEnabled <Boolean>] [-RetentionPolicyCount <Int32>] [-PassThru] [-IgnoreReadOnly] [-WhatIf]
 [-Confirm] [<CommonParameters>]

Id

Set-RMADCollection [-Id] <Int32[]> [-BackupComponents <BackupComponents>] [-Properties <Hashtable>]
 [-Schedule <Schedule[]>] [-ScheduleCredential <PSCredential>] [-AgentCredentialEnabled <Boolean>]
 [-AgentCredential <PSCredential>] [-StorageCredentialEnabled <Boolean>] [-StorageCredential <PSCredential>]
 [-SecondaryStorageCredential <PSCredential>] [-RetentionPolicyEnabled <Boolean>]
 [-RetentionPolicyCount <Int32>] [-PassThru] [-IgnoreReadOnly] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

Sets properties for the Recovery Manager computer collection you specify.

EXAMPLES

Example 1

PS C:\> Set-RMADCollection -Name Collection1 -BackupComponents ActiveDirectory,Registry,GroupMembership,ForestRecoveryMetadata

This command sets properties for the computer collection named Collection1.

Example 2

PS C:\> Set-RMADCollection * -RetentionPolicyEnabled $false

This command disables all backup retention policies for all existing computer collections.

Example 3

PS C:\> $c = Get-RMADCollection | Where-Object { $_.AgentCredentialEnabled -eq $true }

C:\PS>$cred = Get-Credential

C:\PS>Set-RMADCollection -InputObject $c -AgentCredential $cred

The first command in this example gets objects representing the computer collections whose properties are set to access Backup Agent and backup files with a specific user account. Then the command saves the computer collection objects in the $c variable.

Example 4

PS C:\> $a = Get-RMADCollection -Name "Collection1"

C:\PS>Set-RMADCollection -InputObject $a[1] -Properties @{BackupComponents="ActiveDirectory","BootFiles"; UsePreinstalledAgent=$true}

In the first line of this example, the Get-RMADCollection cmdlet gets the Computer Collection whose name is Collection1 and saves it to the $a variable. In the second line of this example, the Set-RMADCollection cmdlet sets the components to be backed up (that is, Active Directory and boot files) and specifies to use preinstalled Backup Agent for backup operations. For a complete list of items you can include in the braces, see the description of the Properties parameter.

Example 5

PS C:\> $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-RMADCollection -InputObject $col -Properties @{EnableEmailLog=$true; EmailLogTo="administrator@mydomain.com"; EmailLogLevel="Everything"}

This example illustrates how to back up a Computer Collection by using two backup schedules. The first line of this example creates two backup creation schedules and stores them in the $schedule variable. One schedule invokes the backup operation once in every two days at 10 a.m. Another schedule invokes the backup operation once in every two days at 10 p.m. The two backup schedules become effective starting from the 20th September 2022. The second line of this example enables e-mail notifications for the Computer Collection. The recipient address for e-mail notifications is administrator@mydomain.com. The e-mail notifications provide information about all backup events.

Example 6

PS C:\> $cred = Get-Credential

C:\PS>Set-RMADCollection -Name MyCollection -Properties @{AgentSideScriptBeforeBackupEnabled = $true; AgentSideScriptBeforeBackup = 'Set-Disk -Number 5 -IsOffline $false'; AgentSideScriptAfterBackupEnabled = $true; AgentSideScriptAfterBackup = 'Set-Disk -Number 5 -IsOffline $true'; AgentSideScriptCredential = $cred}

This example illustrates how to customize your environment by running PowerShell scripts on the domain controller before and after creating a backup.

PARAMETERS

-AgentCredential

Specifies the credentials for the account you want to use to access Backup Agent installed on the DCs in the computer collection and locations where backup files for the computer collection will be saved. TO enable using the account whose credentials you supply in this parameter, use the AgentCredentialEnabled parameter.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-AgentCredentialEnabled

Specifies to use a particular account to access Backup Agent installed on the DCs in the computer collection and locations where backup files for the computer collection will be saved. To specify the credentials for the account, use the AgentCredential parameter.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-BackupComponents

Use this parameter to specify the names of the System State components you want to back up.

Type: BackupComponents
Parameter Sets: (All)
Aliases:
Accepted values: None, ActiveDirectory, Adam, BootFiles, CertificateServer, ClusterQuorum, EnterpriseServices, ForestRecoveryMetadata, GroupMembership, IisMetabase, PerformanceCounters, Registry, CryptoKeys, All

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

-Id

Specifies the identifier of the computer collection whose properties you want to set.

Type: Int32[]
Parameter Sets: Id
Aliases:

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

-InputObject

Renames the computer collection represented by the specified collection objects. Specify the name of the variable that contains the objects or type a command or expression that gets the objects.

Type: ComputerCollection[]
Parameter Sets: InputObject
Aliases:

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

-Name

Specifies the name of the computer collection whose properties you want to set.

Type: String[]
Parameter Sets: Name
Aliases:

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

-PassThru

Passes the computer collection whose properties you have set along the pipeline. If this parameter is omitted, the computer collection is not passed along the pipeline.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

-Properties

Allows you to modify the Computer Collection properties.
To specify the properties you want to modify, use an associative array or hash table. For more information, see the Windows PowerShell help topic on associative arrays (hash tables). To open the topic, at the PoweShell command prompt enter the following: help about_associative_arrayBelow are the properties you can modify by using this parameter. The properties are grouped by the names of tabs in the "Computer Collection Properties" dialog box, because each property corresponds to an option on these tabs. To assign a new value to a property, use the following format: PropertyName=Value

• UseAlternateStoragePath - Specifies whether to store a copy of each backup in an alternate location. Can take one of these values: $true, $false.
• AlternateStoragePath - Specifies a storage path format for the alternate location. Surround the path with double quotes.
• AgentCredentialEnabled - Causes the Recovery Manager console to use a specified user account to access the Backup Agent and backup files on target computers. Can take one of these values: $true, $false.
• AgentCredential - Specifies the account under which the Recovery Manager console accesses the Backup Agent and backup files, in the form of a PSCredential object. Use the Get-Credential cmdlet provided by Windows PowerShell to pass a PSCredential object to this parameter.
• ConfigureFirewall - Specifies whether Recovery Manager automatically configures Windows Firewall on domain controllers to allow backup operations. Can take one of these values: $true, $false.
• UsePreinstalledAgent - Specifies whether Recovery Manager automatically preinstalls the Backup Agent. Can take one of these values: $true, $false.
• DeployForestRecoveryAgent - Specifies whether Recovery Manager verifies that the Forest Recovery Agent is installed on each domain controller in the Computer Collection. Can take one of these values: $true, $false.
• BackupDescription - Specifies a description for the backups to be created for the Computer Collection. The description may include expressions, such as %COMPUTERNAME% and %DATETIME%.
• BackupPasswordEnabled - Specifies whether to protect the backups with a password. Can take one of these values: $true, $false.
• BackupPassword - Specifies a password to protect the backups. The value must be a SecureString object.
• ConsoleSideBackupEnabled - Specifies to store backups on the Recovery Manager computer or on a Universal Naming Convention (UNC) share. Can take one of these values: $true, $false.
• ConsoleSideBackupPath - Specifies a storage path format for backup files. The path format can include expressions, such as %COMPUTERNAME% and %DATETIME%. Surround the path format with double quotes.
• ConsoleSideRetentionPolicyEnabled - Specifies whether to apply a retention policy to backups stored at the path provided in the ConsoleSideBackupPath parameter. Can take one of these values: $true, $false.
• ConsoleSideRetentioPolicyCount - Specifies the number of the most recent backups to retain. Other backups are automatically deleted.
• AgentSideBackupEnabled - Specifies to store backups on the backed-up DC or on a Universal Naming Convention (UNC) share. Can take one of these values: $true, $false.
• AgentSideBackupPath - Specifies a storage path format for backup files. The path format can include expressions, such as %COMPUTERNAME% and %DATETIME%. Surround the path format with double quotes.
• AgentSideRetentionPolicyEnabled - Specifies whether to apply a retention policy to backups stored at the path provided in the ConsoleSideBackupPath parameter. Can take one of these values: $true, $false.
• AgentSideRetentionPolicyCount - Specifies the number of the most recent backups to retain. Other backups are automatically deleted.
• StorageCredentialEnabled - Causes the Recovery Manager console to use a specified user account to access backup files on target computers. Can take one of these values: $true, $false.
• StorageCredential - Specifies the account under which the Recovery Manager Backup Agent accesses the backup files, in the form of a PSCredential object. Use the Get-Credential cmdlet provided by Windows PowerShell to pass a PSCredential object to this parameter.
• EnableEmailLog - Specifies whether to send information about backup creation sessions by e-mail. Can take one of these values: $true, $false.
• EnableEmailLogOnlyOnErrors - Specifies to send information over e-mail only when an error occurs. Can take one of these values: $true, $false.
• EmailLogLevel - Specifies the type of information to send over e-mail. Possible values: "Everything", "ErrorsOnly".
• EmailLogTo - Specifies the recipient's e-mail address to send the information about backup creation sessions.
• EnableApplicationLog - Specifies whether to write information about backup creation sessions to the Windows application log on the Recovery Manager computer. Can take one of these values: $true, $false.
• EnableApplicationLogOnlyOnErrors - Specifies whether to create an Application log event only upon backup creation session errors or warnings. Can take one of these values: $true, $false.
• ApplicationLogLevel - Specifies the type of information to write to the Application log. Possible values: "Everything", "ErrorsOnly".
• EnableLogFile - Specifies whether to write information about backup creation sessions to the additional text file you specify. Can take one of these values: $true, $false.
• EnableLogFileOnlyOnErrors - Specifies whether to write information to the additional text file only upon backup creation session errors or warnings. Can take one of these values: $true, $false.
• LogFileLevel - Specifies the type of information to write to the additional text file. Possible values: "Everything", "ErrorsOnly".
• LogFileName - Specifies a path and name for the additional text file.
• LogFileAppend - Specifies whether to append information to the additional text file. Can take one of these values: "True", "False".
• ExtendedLogging - Specifies the logging settings for DCs in the collection. Can take one of these values: Use global (default) - use settings from the root node: Recovery Manager for Active Directory->Settings…>Logging, Yes - for all DCs in the current collection: for logs will be used the "Trace" option, No - for all DCs in the current collection: in logs will be only Warnings and Error messages.
• CompressionMethod - Specifies a method to compress the backups to be created. Can take one of these values: "None", "Fast", "Normal", "Maximum".
• ParallelBackups - Specifies the maximum number of computers serviced in parallel when creating backups. Increasing this number can speed the backup creation, however, this may result in network saturation and slow network response.
• EnableTransferRateLimit - Specifies whether to limit the total bandwidth used by the Backup Agent when transferring data over the network. Use this property to prevent the Backup Agent from generating excessive network traffic. Can take one of these values: $true, $false.
• TransferRaleLimit - Specifies the bandwidth limit in Mbits/sec for the Backup Agent.
• EnableCpuUsageLimit - Specifies whether to limit the CPU processing time used by the Backup Agent on each computer. Can take one of these values: $true, $false.
• CpuUsageLimit88 - Specifies the CPU processing limit in percent.
• ScheduleEnabled - Specifies whether to enable backup creation schedule. Can take one of these values: $true, $false.
• Schedule - Sets up a backup creation schedule. To set up a schedule, use the New-RMADSchedule cmdlet.
• ScheduleCredential - Specify the user account under which the Task Scheduler performs backup creation tasks, in the form of a PSCredential object. Use the Get-Credential cmdlet provided by Windows PowerShell to pass a PSCredential object to this parameter.
• BackupComponents - Specifies the system state components to back up. Possible values: "All", "None", "ActiveDirectory", "Adam", "BootFiles", "CertificateServer", "ClusterQuorum", "EnterpriseServices", "ForestRecoveryMetadata", "GroupMembership", "IisMetabase", "PerformanceCounters", "Registry". When specifying multiple values, use a comma as a separator.
• CollectGroupMembership - Specifies whether to back up group membership data stored on Global Catalog servers. Can take one of these values: $true, $false.
• CollectForestRecoveryMetadata - Specifies whether to create backups that can be used to recover the Active Directory forest. Can take one of these values: $true, $false.
• OverrideDefaultBackupUnpackSettings - Specifies whether to override the global settings for unpacking backups for the Computer Collection. Can take one of these values: $true, $false.
• UnpackBackupsUponCreation - Specifies whether to unpack each backup upon its creation. Can take one of these values: $true, $false.
• UnpackedBackupsToKeep - Specifies the number of the most recent unpacked backups to retain. Other unpacked backups are automatically deleted.
• IsUnpackOnlySelected - Specifies whether to keep unpacked backups only for a list of selected domain controllers. Can take one of these values: $true, $false.
• SelectedDCsToUnpack - Specifies the names (separated by comma) of domain controllers you want to keep unpacked backups for.
  
  

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

-RetentionPolicyCount

Specifies the number of latest backups you want to keep for each DC in the computer collection. To enable the deletion of obsolete backups, use the RetentionPolicyEnabled parameter.

Type: Int32
Parameter Sets: (All)
Aliases:

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

-RetentionPolicyEnabled

Specifies to delete obsolete backups for particular computer collection. To set the number of latest backups you want to keep for each DC in the computer collection, use the RetentionPolicyCount parameter.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-Schedule

Causes the computer collection you specify to use the backup creation 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

-ScheduleCredential

Specifies the user account under which the scheduled backup creation task will be run. This account must have sufficient permissions to back up the computer collection you specify.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-SecondaryStorageCredential

Specifies the credentials for the account you want to use to Tier 1 remote storage to copy backups to the secondary storage like Secure Storage Server or Cloud Storage.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-StorageCredential

Specifies the credentials for the account you want to use to access locations where backup files for the computer collection will be saved. To enable using the account whose credentials you supply in this parameter, use the StorageCredentialEnabled parameter.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-StorageCredentialEnabled

Specifies to use a particular account to access locations where backup files for the computer collection will be saved. To specify the credentials for the account, use the StorageCredential parameter.

Type: Boolean
Parameter Sets: (All)
Aliases:

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

Set-RMADGlobalOptions

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

schema: 2.0.0

SYNOPSIS

Sets global application settings

SYNTAX

Set-RMADGlobalOptions [-ExchangeOAuth2 <Boolean>] [-EmailServer <String>] [-EmailSender <String>]
 [-ExtendedLogging <Boolean>] [-Properties <Hashtable>] [-IgnoreReadOnly] [-WhatIf] [-Confirm]
 [<CommonParameters>]

DESCRIPTION

Sets Recovery Manager global application settings

EXAMPLES

Example 1

PS C:\> Set-RMADGlobalOptions -ExchangeOAuth2 $False
Set-RMADGlobalOptions -EmailServer "WS.DomainName.local"
Set-RMADGlobalOptions -EmailSender "from@WS.DomainName.local"
Set-RMADGlobalOptions -ExtendedLogging $True

This command sets global email settings to use SMTP Authentication in Recovery Manager for Active Directory.

Example 2

PS C:\> $mailOptions = @{
    "Email.ExchangeOAuth2"  =$True;
    "Email.ApplicationId"   ='111-111-111';
    "Email.TenantId"        ='123-456-789';
    "Email.Thumbprint"      ='abcdefg';
    "Email.Sender"          ='from@WS.DomainName.local'
}
Set-RMADGlobalOptions -Properties $mailOptions

This command sets global email settings to use Exchange OAuth2 in Recovery Manager for Active Directory using the 'Properties' option.

Example 3

PS C:\> $mailOptions = @{
    "Email.ExchangeOAuth2"  =$False;
    "Email.Server"          ='WS.DomainName.local';
    "Email.UseSSL"          =$True;
    "Email.Sender"          ='from@WS.DomainName.local';
    "Email.AuthRequired"    =$True;
    "Email.UserName"        ='SmtpAccount';
    "Email.Password"        ='Password'
}
Set-RMADGlobalOptions -Properties $mailOptions

This command sets global email settings to use SMTP Authentication in Recovery Manager for Active Directory using the 'Properties' option.

Example 4

PS C:\> Set-RMADGlobalOptions -Properties @{"UseRestoreAgentPort" = $True; "DefaultRestoreMethod" = 0; "AgentPort" = 3845 }

This command sets Recovery Manager global settings for agent.

Example 5

PS C:\> $mailOptions = @{
    "Email.ExchangeOAuth2"  =$True;
    "Email.ApplicationId"   ='111-111-111';
    "Email.TenantId"        ='123-456-789';
    "Email.Thumbprint"      ='abcdefg';
    "Email.Sender"          ='from@WS.DomainName.local';
    "Email.GccHighAccount"  =$True
}
Set-RMADGlobalOptions -Properties $mailOptions

This command sets global email settings to use Exchange OAuth2 for U.S. Gcc High Account in Recovery Manager for Active Directory using the 'Properties' option.

PARAMETERS

-EmailSender

Specifies the sender field of email notifications

Type: String
Parameter Sets: (All)
Aliases:

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

-EmailServer

Specifies the SMTP server for email notifications

Type: String
Parameter Sets: (All)
Aliases:

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

-ExchangeOAuth2

Specifies Exchange OAuth2 mode for email notifications

Type: Boolean
Parameter Sets: (All)
Aliases:

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

-ExtendedLogging

Specifies diagnostic logs

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

-Properties

Allows you to modify the application settings.
To specify the properties you want to modify, use an associative array or hash table.
For more information, see the Windows PowerShell help topic on associative arrays (hash tables).
To open the topic, at the PoweShell command prompt enter the following: help about_associative_array Below are the properties you can modify by using this parameter.
The properties are grouped by the names of tabs in the "Computer Collection Properties" dialog box, because each property corresponds to an option on these tabs.To assign a new value to a property, use the following format: PropertyName=Value E-MAIL TAB

• Email.ExchangeOAuth2. Specifies the Exchange OAuth2 mode for email notifications
• Email.Server. Specifies the SMTP server for email notifications
• Email.Port. Specifies the SMTP port for email notifications
• Email.Sender. Specifies the sender of email notifications
• Email.ApplicationId. Specifies the application (client) ID for Exchange OAuth2 email notifications
• Email.TenantId. Specifies the directory (tenant) ID for Exchange OAuth2 email notifications
• Email.GccHighAccount. Specifies the U.S. Gcc High account option for Exchange OAuth2 email notifications
• Email.Thumbprint. Specifies the thumbprint for Exchange OAuth2 email notifications LOGGING TAB
• ExtendedLogging. Specifies option "Use diagnostic logging"
• LogsFolder. Specify the directory for application logs.
  
  

Type: Hashtable
Parameter Sets: (All)
Aliases:

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

Set-RMADHybridRecoveryDomainOptions

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

Set-RMADHybridRecoveryDomainOptions -Domain <String> -DomainController <String> -Credentials <PSCredential>
 [-IgnoreReadOnly] [-WhatIf] [-Confirm] [<CommonParameters>]

DESCRIPTION

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

EXAMPLES

Example 1

PS C:\>$password = ConvertTo-SecureString 'mypassword' -AsPlainText -Force
PS C:\>$credentials = New-Object System.Management.Automation.PSCredential ('rmad-admin', $password)
PS C:\>Set-RMADHybridRecoveryDomainOptions -Domain rmad.local -DomainController DC1.rmad.local -Credentials $credentials

Returns: Nothing on success; otherwise an error

PARAMETERS

-Credentials

Credentials used for connecting to the system that is running the Azure Active Directory Connector.

Type: PSCredential
Parameter Sets: (All)
Aliases:

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

-Domain

Domain which the Hybrid Connector will be using.

Type: String
Parameter Sets: (All)
Aliases:

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

-DomainController

The domain Controller that the Azure Active Directory Connector is installed on.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
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

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