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

# Configurer LAPS avec une entrée d'identifiants personnalisée

Le guide suivant décrit comment ajouter un script PowerShell dans une entrée d'informations d'identification personnalisée pour se connecter à une machine distante à l'aide de [Windows LAPS](https://learn.microsoft.com/en-us/windows-server/identity/laps/laps-overview). Windows LAPS est requis et doit être correctement configuré dans votre environnement pour utiliser cette solution.

{% hint style="success" %}
À partir de Remote Desktop Manager v.2024.3, les entrées d'informations d'identification LAPS sont des entrées officielles et n'ont plus besoin d'être créées manuellement. Le paramètre ***Nom d'utilisateur*** de l'hôte doit tout de même être modifié pour pointer vers l'hôte distant, sinon l'authentification utilisera l'hôte local par défaut. Pour effectuer cette modification, saisissez $HOST$\username (*username* représente le nom d'utilisateur de l'hôte distant) dans le champ ***Général*** – ***Hôte*** - ***Nom d'utilisateur***.
{% endhint %}

1\. Dans Remote Desktop Manager Windows, créez une nouvelle entrée dans le ***Ruban*** sous l'onglet ***Modifier***. 2. Dans ***Gestion des informations d'identification***, sélectionnez le type d'entrée ***Personnalisé***.

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

3. Nommez votre entrée et sélectionnez son dossier de destination.
4. Dans l'onglet ***Général***, assurez-vous que le menu déroulant est défini sur ***PowerShell***.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2335.png)
5. Ajoutez le script PowerShell suivant dans la zone ***Commande***.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Le script utilise la variable <code>$HOST$</code> pour le paramètre <code>-ComputerName</code> de la cmdlet <code>Get-LapsADPassword</code> et utilise la variable <code>$PARAMETER1$</code> pour le nom d'utilisateur (voir l'étape 6 ci-dessous). Selon votre environnement, le <code>$PARAMETER$</code> pourrait être lié à <code>-Identity</code>. Vous pouvez également configurer le <em><strong>Paramètre n° 2</strong></em> pour définir le nom d'utilisateur dont vous avez besoin et modifier la valeur du script de <code>%USERNAME%</code> à <code>$PARAMETER2$</code>. Nous recommandons de lancer Remote Desktop Manager en tant qu'administrateur pour obtenir des autorisations élevées.</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. Dans l'onglet ***Paramètres***, ajoutez le nom du compte administrateur local dans le champ ***Paramètre n° 1***.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2337.png)
7. Cliquez sur ***Ajouter*** pour enregistrer l'entrée dans le dossier de destination spécifié.
8. Dans les propriétés de votre entrée RDP, définissez la propriété des informations d'identification pour utiliser l'entrée d'informations d'identification ***Personnalisé*** nouvellement créée.

   ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2338.png)
9. Toujours dans les propriétés de l'entrée RDP, accédez à ***Avancé*** – ***Avancé***.
10. Définissez la propriété ***Remplacer le domaine*** sur ***Utiliser le nom de l'hôte*** et la propriété ***Format du nom d'utilisateur*** sur ***{Domain}\\{User}***.

    ![](https://cdnweb.devolutions.net/docs/docs_en_kb_KB2339.png)
11. Cliquez sur ***Mettre à jour*** pour enregistrer vos modifications.

L'entrée RDP est maintenant prête à être utilisée et à se connecter avec le compte administrateur local géré par Windows LAPS.


---

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