PA Promote Example

Parallels RAS PowerShell - Connection Broker Promote Example

#Establish a connection with Parallels RAS (Replace Administrator with your RAS root account). New-RASSession Administrator

###### FARM CONFIGURATION ######

#Activate Parallels RAS with a valid key (you will have to provide a valid Parallels My Account password). Invoke-RASLicenseActivate -Email "[e-mail]" -Key "YOUR-LICENSE-KEY"

#Add the backup Connection Broker server. New-RASBroker -Server broker.company.dom

#Apply all settings. This cmdlet performs the same action as the Apply button in the RAS console. Invoke-RASApply

#Get the list of connection Brokers. Get-RASBroker

ID      Site ID         Server               Enabled          Standby           Priority
--      ------          ------               ----------       ------------      --------------           
1            1          primary.company.dom  True             False             0
2            1          broker.company.dom       True             False             1
                    

#End the current RAS session. Remove-RASSession

###### END FARM CONFIGURATION ######

###### TESTING CONNECTION BROKER PROMOTION ######

#Establish a connection with Parallels RAS (Replace Administrator with your RAS root account). New-RASSession Administrator -Server "broker.company.dom" -Force

#Get the backup Broker server. $BackupBroker = Get-RASBroker -Server broker.company.dom

#Promote backup Broker to primary (you will have to provide a valid Parallels My Account password). Invoke-RASBrokerPromoteToPrimary -Id $BackupBroker.Id -Email "[e-mail]"

#After the Broker promotion to Primary the session is logged out, then a new session needs to be created. Establish a connection with Parallels RAS (Replace Administrator with your RAS root account). New-RASSession Administrator -Server "broker.company.dom" -Force

#Apply all settings. This cmdlet performs the same action as the Apply button in the RAS console. Invoke-RASApply

#Get the list of Connection Brokers. Get-RASBroker

ID      Site ID         Server               Enabled          Standby           Priority
--      ------          ------               ----------       ------------      --------------           
1            1          primary.company.dom  True             False             1
2            1          broker.company.dom   True             False             0
                    

#End the current RAS session. Remove-RASSession

###### END TESTING CONNECTION BROKER PROMOTION ######

© 2025 Parallels International GmbH. Parallels and the Parallels logo are trademarks or registered trademarks of Parallels International GmbH in Canada, the U.S., and/or elsewhere.