> 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/rdm/de/knowledge-base/how-to-articles/configure-laps-with-a-custom-credentials-entry.md).

# LAPS mit einem Eintrag für benutzerdefinierte Anmeldeinformationen konfigurieren

Die folgende Anleitung beschreibt, wie Sie ein PowerShell-Skript in einem benutzerdefinierten Eintrag für Anmeldeinformationen hinzufügen, um sich mithilfe von [Windows LAPS](https://learn.microsoft.com/en-us/windows-server/identity/laps/laps-overview) mit einem Remote-Rechner zu verbinden. Windows LAPS ist erforderlich und muss in Ihrer Umgebung ordnungsgemäß konfiguriert sein, um diese Lösung zu verwenden.

{% hint style="success" %}
Ab Remote Desktop Manager v.2024.3 sind LAPS-Einträge für Anmeldeinformationen offizielle Einträge und müssen nicht mehr benutzerdefiniert erstellt werden. Die Einstellung ***Username*** des Hosts muss weiterhin auf den Remote-Host geändert werden, andernfalls verwendet die Authentifizierung standardmäßig den lokalen Host. Um diese Änderung vorzunehmen, geben Sie $HOST$\username (*username*steht für den Benutzernamen des Remote-Hosts) im Feld ***General*** – ***Host*** - ***Username*** ein.
{% endhint %}

1\. Erstellen Sie in Remote Desktop Manager Windows einen neuen Eintrag im Menüband unter der Registerkarte ***Edit***. 2. Wählen Sie unter ***Credential management*** den Eintragstyp ***Custom*** aus.

![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2334.png)

3. Benennen Sie Ihren Eintrag und wählen Sie dessen Zielordner aus.
4. Stellen Sie auf der Registerkarte ***General*** sicher, dass das Dropdown-Menü auf ***PowerShell*** eingestellt ist.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2335.png)
5. Fügen Sie das folgende PowerShell-Skript im Feld ***Command*** hinzu.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Das Skript verwendet die Variable <code>$HOST$</code> für den Schalter <code>-ComputerName</code> des Cmdlets <code>Get-LapsADPassword</code> und die Variable <code>$PARAMETER1$</code> für den Benutzernamen (siehe Schritt 6 unten). Je nach Ihrer Umgebung könnte sich <code>$PARAMETER$</code> auf <code>-Identity</code> beziehen. Sie können auch <em><strong>Parameter #2</strong></em> konfigurieren, um den benötigten Benutzernamen festzulegen, und den Skriptwert von <code>%USERNAME%</code> auf <code>$PARAMETER2$</code> ändern. Wir empfehlen, Remote Desktop Manager als Administrator zu starten, um erweiterte Berechtigungen zu erhalten.</p></div>

```powershell
Import-Module LAPS -ErrorAction SilentlyContinue
$isImport = Get-Module -List LAPS
if ($isImport)
{
    try
        {
         $null2 = [System.DirectoryServices.ActiveDirectory.Domain]::GetComputerDomain()
         $isDomain = $true
        }
    catch
        {
         $isDomain = $false
        }

    if ($isDomain)
    {
        $MyPassword=Get-LapsADPassword -Identity $PARAMETER1$ -AsPlainText
        if ($MyPassword.Password)
           {
            $Result.Username="%USERNAME%"
            $Result.Password=$MyPassword.Password
           }
        else
           {
            $Result.Cancel=$True
            $Result.ErrorMessage="LAPS did not return any value!"
           }
    }
    else
    {
        $Result.Cancel=$True
        $Result.ErrorMessage="Your computer must be connected to a domain to use LAPS features!"
    }
}
else
{
        $Result.Cancel=$True
        $Result.ErrorMessage="The LAPS module must be installed in this architecture!"
}
```

![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2336.png)

6. Fügen Sie auf der Registerkarte ***Parameters*** den Namen des lokalen Administratorkontos im Feld ***Parameter #1*** hinzu.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2337.png)
7. Klicken Sie auf ***Add***, um den Eintrag im angegebenen Zielordner zu speichern.
8. Legen Sie in den Eigenschaften Ihres RDP-Eintrags die Eigenschaft für Anmeldeinformationen so fest, dass der neu erstellte Eintrag für ***Custom***-Anmeldeinformationen verwendet wird.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2338.png)
9. Gehen Sie weiterhin in den Eigenschaften des RDP-Eintrags zu ***Advanced*** – ***Advanced***.
10. Setzen Sie die Eigenschaft ***Override domain*** auf ***Use Host Name*** und die Eigenschaft ***Username format property*** auf ***{Domain}\\{User}***.

    ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2339.png)
11. Klicken Sie auf ***Update***, um Ihre Änderungen zu speichern.

Der RDP-Eintrag ist nun bereit, verwendet zu werden und sich mit dem von Windows LAPS verwalteten lokalen Administratorkonto zu verbinden.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/rdm/de/knowledge-base/how-to-articles/configure-laps-with-a-custom-credentials-entry.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
