search
ProductsSupportPartnersDocumentation

Agent Example

hashtag
Parallels RAS PowerShell - RAS Agent Example

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

#Adding two RAS RDSs New-RASRDS -Server "rds1.company.dom" -Username administrator New-RASRDS -Server "rds2.company.dom" -Username administrator

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

# Get all available RAS Agents information Get-RASAgent

ID      Site ID         Server              Type             State            Agent Version         Server OS              
--      ------          ------              ----------       ----------       --------              --------              
1            1          broker.company.dom      BROKER               OK       16.1 (build 1...      Microsoft Win...      
1            1          rds1.company.dom           RDS               OK       16.1 (build 1...      Microsoft Win...      
1            1          gw.company.dom         Gateway      NotVerified                                                   
2            1          rds2.company.dom           RDS               OK       16.1 (build 1...      Microsoft Win...

# Get the RAS Agent information (by server name 'rds1.company.dom') Get-RASAgent -Server rds1.company.dom | Format-Table

ID      Site ID         Server              Type            State              Agent Version        Server OS
--      ------          ------              ----------      ----------         --------             --------
1            1          rds1.company.dom           RDS              OK         16.1 (build 1...     Microsoft Win...

#Update RDS RAS Agent (by input object) $rdsAgent = Get-RASAgent -Server rds1.company.dom Update-RASAgent -InputObject $rdsAgent -Username administrator

#Update RDS RAS Agent (by server name 'rds2.company.dom') Update-RASAgent -Server rds2.company.dom -Username administrator

# Get all RAS Agents information of type RDS Get-RASAgent -ServerType RDS | Format-Table

# Removing RAS Agent (by server name 'rds2.company.dom') Remove-RASAgent -Server rds2.company.dom -Username administrator

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

# Get all available RAS Agents information Get-RASAgent

#End the current RAS session. Remove-RASSession

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

PreviousPublishing ExampleNextRDS Template Example

Last updated