Create a Devolutions Server Data Source with an Application Key

With the Devolutions.PowerShell module, it is possible to connect to a Devolutions Server instance using an Application key and Application Secret. You can create a Devolutions Server data source in Remote Desktop Manager or manually using PowerShell. Follow the method that best suits your needs.

Steps

Method 1: Remote Desktop Manager

  1. In Remote Desktop Manager, go to File – Data Sources.
  2. Click the Add a New Data Source button.
    File – Data Sources – Add a New Data Source.png
    File – Data Sources – Add a New Data Source.png
  3. In the next window, select the Devolutions Server team data source, then click OK.
    Devolutions Server Data Source.png
    Devolutions Server Data Source.png
  4. In the General tab, enter a Name, a Host, and a Username for your new data source. You can then click on the Test Connection button to confirm that the connection is working.
    General Tab.png
    General Tab.png
  5. Click on the PowerShell tab.
    PowerShell Tab.png
    PowerShell Tab.png
  6. Enter your Application key and Application Secret in the Tenant ID field and the Password field respectively, then click OK.

Your new Devolutions Server data source is now created. You can now connect to your Devolutions Server and run your scripts.

Method 2: PowerShell

  1. Using the PowerShell cmdlets, paste the following sample script:

    $dsname = "DVLS PowerShell"
    $dsurl = "https<area>://your_dvls_url"
    $appkey = "your_appkey"
    $appsecret = "your_appsecret"
    
    $ds = New-RDMDataSource -DVLS -Name $dsname -Server $dsurl -ScriptingTenantID $appkey -ScriptingApplicationPassword $appsecret -SetDatasource -WarningAction SilentlyContinue
    Set-RDMDataSource $ds
    Set-RDMCurrentDataSource $ds
    
  2. Replace the variable values with your own, then run the script.

Your new Devolutions Server data source is now created. You can now connect to your Devolutions Server and run your scripts.