Recovery Manager for AD 10.3 - Management Shell Guide

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.

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

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