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