# Agent Example ## Parallels RAS PowerShell - RAS Agent Example \#Establish a connection with Parallels RAS (Replace Administrator with your RAS root account).\ [New-RASSession](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASSession) Administrator \#Adding two RAS RDSs [New-RASRDS](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASRDS) -Server "rds1.company.dom" -Username administrator\ [New-RASRDS](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#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](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Invoke-RASApply) \# Get all available RAS Agents information [Get-RASAgent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#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](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#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](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Get-RASAgent) -Server rds1.company.dom\ [Update-RASAgent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Update-RASAgent) -InputObject $rdsAgent -Username administrator \#Update RDS RAS Agent (by server name 'rds2.company.dom') [Update-RASAgent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Update-RASAgent) -Server rds2.company.dom -Username administrator \# Get all RAS Agents information of type RDS [Get-RASAgent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Get-RASAgent) -ServerType RDS | 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... 2 1 rds2.company.dom RDS OK 16.1 (build 1... Microsoft Win... ``` \# Removing RAS Agent (by server name 'rds2.company.dom') [Remove-RASAgent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#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](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Invoke-RASApply) \# Get all available RAS Agents information [Get-RASAgent](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#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 ``` \#End the current RAS session.\ [Remove-RASSession](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Remove-RASSession) © 2026 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.