# 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/v20/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/v20/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/v20/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/v20/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/v20/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/v20/parallels-ras-powershell-admin-module/index#Invoke-RASApply)

\#End the current RAS session.\
[Remove-RASSession](https://docs.parallels.com/landing/ras-powershell-api-guide/v20/parallels-ras-powershell-admin-module/index#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.
