> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/server/knowledge-base/how-to-articles/create-a-devolutions-server-workspace-with-an-application-key.md).

# Create a Devolutions Server workspace 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***](https://docs.devolutions.net/server/web-interface/administration/security-management/applications/). You can create a Devolutions Server workspace in Remote Desktop Manager or manually using PowerShell. Follow the method that best suits your needs.

#### Method 1: Remote Desktop Manager

1. In Remote Desktop Manager, go to ***File – Workspaces***.
2. Click the ***Add a new workspace*** button.

   <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB2117.png" alt=""><figcaption></figcaption></figure>
3. In the next window, select the ***Devolutions Server*** team workspace, then click ***OK***.

   <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB2118.png" alt=""><figcaption></figcaption></figure>
4. In the ***General*** tab, enter a ***Name***, a ***Host***, and a ***Username*** for your new workspace. You can then click on the ***Test Connection*** button to confirm that the connection is working.

   <figure><img src="https://cdnweb.devolutions.net/docs/DVLS6069_2024_3.png" alt=""><figcaption></figcaption></figure>
5. Click on the ***PowerShell*** tab.

   <figure><img src="https://cdnweb.devolutions.net/docs/docs_en_kb_KB2119.png" alt=""><figcaption></figcaption></figure>
6. Enter your [***Application key and Application Secret***](https://docs.devolutions.net/server/web-interface/administration/security-management/applications/) in the ***Tenant ID*** field and the ***Password*** field respectively, then click ***OK***.

Your new Devolutions Server workspace 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:

   ```powershell
   $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 workspace is now created. You can now connect to your Devolutions Server and run your scripts.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.devolutions.net/server/knowledge-base/how-to-articles/create-a-devolutions-server-workspace-with-an-application-key.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
