Devolutions ForumDevolutions Forum

Scripting documentation

Scripting documentation

avatar
(user deleted)
Disabled

Is there any thorough examples of using the scripting interfaces such as PowerShell mechanism or applescript?

You can see the examples below. I want to be able to reference an entry by id or search by name. Then return 1 of the 3 values host, username or password of a matched entry.

---
I found this works on AppleScript:
tell application "Remote Desktop Manager Free"

--return properties of every entry
get value from entry id "cc4cf003-87b7-4da2-abbf-bd7287636790" of property ""
end tell

but there is no documentation on what the property's are. The commented out line returns the name of some other info.


---


Powershell i could only get the basics to work such as:


PS /Users/aaa> Get-RDMInstance

ApplicationVersion OptionFilename
------------------ --------------
2022.2.2.0 /Users/gfn4/Library/Application Support/com.devolutions.remotedesktopmanager/Re…

PS /Users/gfn4> Get-RDMDataSource

ID : ****
IsConnected : False
IsOffline : False
Name : Local Data Source
Type : SQLite

ID : ***
IsConnected : True
IsOffline : False
Name : test
Type : SQLite

All Comments (3)

avatar
Erica Poirier

Hello,

There is no online documentation that describes all properties of all objects available in RDM.

But there is a method to find the properties you are looking for. Right-click on an entry in RDM and select Clipboard - Copy - Preview. You should see the XML content of the entry that contains all configured properties.

forum image

forum image

Let me know if that helps.

Best regards,

Érica Poirier

avatar
Xavier Fortin

Hi georgesnow,

I can only comment on AppleScript as I'm far from familiar with PowerShell. The simple answer to your question is unfortunately no. The list of all possible properties are unfortunately not documented anywhere.

To your specific point, I was about to suggest using Host, HostUsername and HostPassword. But unfortunately there is a bug currently that makes HostUsername and HostPassword not work. Those are special properties that allow getting the username and password of any entry regardless of their types. I've fixed the issue internally, but for now, there's not much to do.

In any case, PowerShell does and will receive a lot more support than AppleScript (considering that this is a whole project supported by it's own team). It's probably advisable to use it instead. I'll ping the PowerShell team to see if someone can help you.

Best regards,

Xavier Fortin

avatar
Jonathan Lafontaine

Hi georgesnow,

In PowerShell, you can achieve your goal this way.

$session = Get-RDMSession -Name "session name"
# if you want to search for a specific ID, you can do
# $session = Get-RDMSession | where {$_.ID -eq "id here"}
$host = $session.Host
$username = Get-RDMSessionUsername $session
$domain = Get-RDMSessionDomain $session
$password = Get-RDMSessionPassword $session
# $password will be a secure string at this point, if you need the password in clear text, you can do
# $password = ConvertFrom-SecureString $password -AsPlainText


Let me know if you have further questions regarding PowerShell.
Regards

Jonathan Lafontaine