Agent Example

Parallels RAS PowerShell - RAS Agent Example

#Establish a connection with Parallels RAS (Replace Administrator with your RAS root account). New-RASSession Administrator

#Adding two RAS RDSs New-RASRDS -Server "rds1.company.dom" -Username administrator 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

# Get all available RAS Agents information 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 -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 -Server rds1.company.dom Update-RASAgent -InputObject $rdsAgent -Username administrator

#Update RDS RAS Agent (by server name 'rds2.company.dom') Update-RASAgent -Server rds2.company.dom -Username administrator

# Get all RAS Agents information of type RDS 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 -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

# Get all available RAS Agents information 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

© 2024 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.