# Status Info Example ## Parallels RAS PowerShell - Status Info 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 \###### RDS status info ###### \#Adding a RAS RDS [New-RASRDS](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASRDS) -Server "rds.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 RDS status info [Get-RASRDSStatus](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Get-RASRDSStatus) -Server rds.company.dom ``` ID Site ID Server CPU Load Memory Load Agent State -- ------ ------ ---------- ------------ -------------- 1 1 rds.company.dom 8 15 OK ``` \###### Gateway status info ###### \#Adding a RAS Gateway [New-RASGateway](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASGateway) -Server "gw\.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 Gateway status info [Get-RASGatewayStatus](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Get-RASGatewayStatus) -Server gw\.company.dom ``` ID Site ID Server CPU Load Memory Load Agent State -- ------ ------ ---------- ------------ -------------- 1 1 gw.company.dom 13 47 OK ``` \###### Connection Broker status info ###### \#Adding a RAS Connection Broker [New-RASBroker](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASBroker) -Server "broker.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 Connection Broker status info [Get-RASBrokerStatus](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Get-RASBrokerStatus) -Server broker.company.dom ``` ID Site ID Server CPU Load Memory Load Agent State -- ------ ------ ---------- ------------ -------------- 1 1 broker.company.dom 2 46 OK ``` \###### Site status info ###### \#Adding a RAS Site [New-RASSite](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASSite) -Server "site.company.dom" -Name "MySite" -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 Site status info [Get-RASSiteStatus](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Get-RASSiteStatus) -Server site.company.dom ``` ID Site ID Server CPU Load Memory Load Agent State -- ------ ------ ---------- ------------ -------------- 1 1 site.company.dom 0 0 OK ``` \###### Provider status info ###### \#Add a Provider servers. $Provider = [New-RASProvider](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASProvider) -Server "vdi.company.dom" -VMwareESXi -VmwareESXiVersion v6\_5 -VDIUsername root -VDIAgent "vdiagent.company.do" -Username root \#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 Provider status info [Get-RASProviderStatus](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Get-RASProviderStatus) -Id $Provider.Id ``` ID Site ID Server CPU Load Memory Load Agent State -- ------ ------ ---------- ------------ -------------- 1 1 vdi.company.dom 18 60 OK ``` \#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.