# Basic Example

## Parallels RAS PowerShell - Basic 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

\#Add a RAS Secure Gateway (replace 'gw\.company.dom' with a valid FQDN, computername, or IP address).\
[New-RASGateway](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASGateway) -Server "gw\.company.dom"

\#Add an RD Session Host server (replace 'rds.company.dom' with a valid FQDN, computer name, or IP address).\
[New-RASRDS](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASRDS) -Server "rds.company.dom"

\#Add a published desktop.\
[New-RASPubRDSDesktop](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#New-RASPubRDSDesktop) -Name "PubDesktop"

\#Activate Parallels RAS as a trial (you will have to provide a valid Parallels My Account email and password).\
[Invoke-RASLicenseActivate](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/index#Invoke-RASLicenseActivate)

\#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)

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